Get verification result

Request

Retrieves the results of the verification session, which contains detailed information about the submitted documents (including PII). This should be called from the backend.

Security

verify_access_token

Path

sidanyrequired

Session ID returned upon session creation or in the callback URL upon completing the verification

Query

detailedbooleandeprecated

This parameter allows existing customers to select between response objects. You should explicitly send false to return the DeprecatedSessionResult response structure or send true to return the new CompleteSessionResult/IncompleteSessionResult response structure. Please note this parameter will be removed once DeprecatedSessionResult is fully deprecated.

Example:detailed=false

curl -i -X GET \
  'https://api.sbx.transmitsecurity.io/verify/api/v1/verification/{sid}/result?detailed=false' \
  -H 'Authorization: Bearer <YOUR_jwt_HERE>'

Responses

Bodyapplication/json

One of:

session_idstringrequired

ID of the verification session

statusstringrequired

Status of the verification session. See verification statuses

Value:"complete"

recommendationstringrequired

Aggregated result of the verification checks. See recommendations

Enum:"ALLOW""CHALLENGE""DENY"

Example:"DENY"

risk_detailsobject

Detailed risk information collected during the verification flow.

personobjectrequired

Information about the person in this session.

documentobjectrequired

Information about the document in this session.

additional_infoobject

Additional information extracted from this session.

checksobjectrequired

The verification checks performed in this session.

verification_imagesArray of objectsrequired

Images used for verification

Response

{
  "session_id": "string",
  "status": "complete",
  "recommendation": "DENY",
  "risk_details": {
    "general": { … },
    "device": { … },
    "network": { … },
    "recommendation_reasons": [ … ]
  },
  "person": {
    "full_name": "Marie Salomea Skłodowska-Curies",
    "given_name": "Marie",
    "surname": "Curies",
    "gender": "female",
    "national_id": "123ABC",
    "date_of_birth": "1867-11-07T00:00:00.000Z",
    "age": 35
  },
  "document": {
    "country": "US",
    "region": "NY",
    "type": "national_id",
    "number": "1234567",
    "serial_number": "1234567",
    "issue_date": "1867-11-07T00:00:00.000Z",
    "expiration_date": "1867-11-07T00:00:00.000Z"
  },
  "additional_info": {
    "address": { … },
    "national_status": { … },
    "employment": { … }
  },
  "checks": {
    "document_validation": { … },
    "document_authentication": { … },
    "document_liveness": { … },
    "biometric_matching": { … },
    "biometric_liveness": { … },
    "flagged_identity": { … },
    "risk_recommendation": { … }
  },
  "verification_images": [
    { … }
  ]
}