Skip to content

Validate a token

GET
/v1/auth/validate
curl --request GET \
--url https://api.nextpki.com/v1/auth/validate \
--header 'Authorization: Bearer <token>'

Confirms the token and reports the tenant and scopes it carries. Requires no particular scope - use it as a health check for credentials.

Token is valid

Media typeapplication/json
object
valid
boolean
tenant_id
string format: uuid
name
string
scopes
Array<string>
Examplegenerated
{
"valid": true,
"tenant_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"name": "example",
"scopes": [
"example"
]
}

Missing, malformed, unknown or revoked token

Media typeapplication/json
object
error
string
Examplegenerated
{
"error": "example"
}