Skip to content

GET /verify/status

Read-only check on a verification session's state. Does not consume the session or require authentication — the session token itself is the capability. Useful for confirming a session is still valid before sending a user to verify_url.

Request

GET /verify/status?session=<token>
Query paramRequiredDescription
sessionYesThe session value returned by /verify/init.

Response — 200 OK

json
{ "valid": true }

Errors

StatusCause
400session query param missing
404Session not found or expired
409Session already used
410Session expired

See Errors for the full response shape.

Not affiliated with Pi Network or the Pi Core Team.