Validate a verification result token
Publisher-backend-only operation. Call it with Authorization: Bearer emb_sk_*;
public keys do not authenticate this operation. The JSON request body contains
only result_token.
Validates and consumes a hosted-flow result_token. Tokens are single-use with a
5-minute TTL. Result tokens are issued only after successful
verification. Failed and expired sessions do not produce
result_token values and should be tracked via webhooks. This endpoint is
the authoritative source for successful verification facts; redirect
parameters are not guaranteed beyond result_token, session_id, and
optional state.
Authorization
bearerAuth Your secret API key (emb_sk_...) from the Emblem dashboard. Pass as "Bearer emb_sk_..." in the Authorization header.
In: header
Request Body
application/json
Opaque token returned to callback_url after successful verification (TTL 5 minutes, single-use). Must be validated via this endpoint.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://app.emblemapp.com/api/v1/verify/validate" \ -H "Content-Type: application/json" \ -d '{ "result_token": "string" }'{
"valid": true,
"session_id": "string",
"verified": true,
"level": "L1",
"challenge_age": 0,
"integration_id": "55d7337e-1d0a-49fc-9826-925ba40df035",
"validated_at": "2019-08-24T14:15:22Z"
}{
"error": "string",
"error_code": "string",
"message": "string",
"code": "VALIDATION_ERROR",
"details": [
"string"
],
"request_id": "string",
"correlation_id": "string"
}{
"error": "string",
"error_code": "string",
"message": "string",
"code": "VALIDATION_ERROR",
"details": [
"string"
],
"request_id": "string",
"correlation_id": "string"
}{
"error": "string",
"error_code": "string",
"message": "string",
"code": "VALIDATION_ERROR",
"details": [
"string"
],
"request_id": "string",
"correlation_id": "string"
}{
"error": "string",
"error_code": "string",
"message": "string",
"code": "VALIDATION_ERROR",
"details": [
"string"
],
"request_id": "string",
"correlation_id": "string"
}{
"error": "string",
"error_code": "string",
"message": "string",
"code": "VALIDATION_ERROR",
"details": [
"string"
],
"request_id": "string",
"correlation_id": "string"
}