Skip to content

Verify token

POST
/v1/auth/verify
curl --request POST \
--url https://api.neuramancer.dev/v1/auth/verify \
--header 'Content-Type: application/json' \
--data '{ "idToken": "example" }'

Verifies that a provided token is valid by checking it against Firebase. This is intentionally an unauthenticated endpoint - the token to verify is passed in the request body, allowing clients to check token validity without an active middleware session.

Media typeapplication/json
object
idToken
required

Firebase ID token to verify

string
Examplegenerated
{
"idToken": "example"
}

Token is valid

Media typeapplication/json

Standardized success response with a confirmation message, following the APIResponse schema.

object
success
required
boolean
data
required
object
message
required

Confirmation message

string
Example
{
"success": true
}

Missing idToken

Media typeapplication/json

Standardized error response following the APIResponse schema.

object
success
required
boolean
message
required
string
Example
{
"success": false,
"message": "Bad request"
}

Invalid or expired token

Media typeapplication/json

Standardized error response following the APIResponse schema.

object
success
required
boolean
message
required
string
Example
{
"success": false,
"message": "Bad request"
}

Server error during verification

Media typeapplication/json

Standardized error response following the APIResponse schema.

object
success
required
boolean
message
required
string
Example
{
"success": false,
"message": "Bad request"
}