Reconcile a verification session
Returns a narrow, publisher-facing view of a hosted verification session for recovery and reconciliation. This endpoint is useful when a publisher needs to confirm the final state of a specific session after a transient failure, a missed or delayed webhook, or for operational debugging.
This endpoint is not a replacement for publisher webhooks, which remain
the recommended lifecycle integration mechanism. It is also not a
replacement for POST /api/v1/verify/validate, which remains the success
confirmation path for hosted result_token values.
Result tokens are issued only after successful verification outcomes.
Failed and expired sessions do not produce result tokens.
In production, this endpoint is rate limited for recovery use cases and
returns 429 RATE_LIMITED with Retry-After when limits are exceeded.
Authorization
bearerAuth Your secret API key (emb_sk_...) from the Emblem dashboard. Pass as "Bearer emb_sk_..." in the Authorization header.
In: header
Path Parameters
Verification session identifier (emb_sess_...).
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://app.emblemapp.com/api/v1/verify/sessions/string"{
"session_id": "emb_sess_pending123",
"status": "PENDING",
"verified": null,
"failure_code": null,
"failure_reason": null,
"level": "L1",
"challenge_age": 25,
"completed_at": null,
"expires_at": "2026-01-01T00:10:00.000Z",
"result_available": false
}{
"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"
}