# Get verification result

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

Endpoint: GET /api/v1/verification/{sid}/result
Security: verify_access_token

## Path parameters:

  - `sid` (any, required)
    Session ID returned upon session creation or in the callback URL upon completing the verification

## Query parameters:

  - `detailed` (boolean)
    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.

## Response 200 fields (application/json):

  - `session_id` (string, required)
    ID of the verification session

  - `status` (string, required)
    Status of the verification session.
See [verification statuses](/guides/verify/identity_verification_result/#verification-status)
    Enum: "complete"

  - `recommendation` (string, required)
    Aggregated result of the verification checks.
See [recommendations](/guides/verify/identity_verification_result/#recommendations)
    Enum: "ALLOW", "CHALLENGE", "DENY"

  - `risk_details` (object)
    Detailed risk information collected during the verification flow.

  - `risk_details.general` (object)
    General Fraud Prevention details for the verification action.

  - `risk_details.general.correlation_id` (string)
    Unique correlation ID for the verification action.
    Example: SUMCposIdWZfgNp

  - `risk_details.general.action_type` (string)
    Type of action assessed by Fraud Prevention.
    Example: identity_verification

  - `risk_details.general.recommendation` (string)
    Fraud Prevention recommendation for the verification action.
    Example: rejected

  - `risk_details.general.risk_score` (number)
    Risk score calculated by Fraud Prevention.
    Example: 94.6

  - `risk_details.device` (object)
    Device risk details collected during the verification flow.

  - `risk_details.device.os` (string)
    Operating system used by the device.
    Example: Android

  - `risk_details.device.browser` (string)
    Browser used by the device.
    Example: Chrome

  - `risk_details.device.device_id` (string)
    Unique device identifier.
    Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9

  - `risk_details.device.device_fingerprint` (string)
    Device fingerprint hash.
    Example: 4ebf21edcb4297363ad239386fc6e45e34123045f6ac7b9da93c415d7cb60bdc

  - `risk_details.device.device_type` (string)
    Type of device used for the verification.
    Enum: "mobile", "desktop"

  - `risk_details.device.device_model` (string)
    Device model used for the verification.
    Example: SM-G955U

  - `risk_details.device.device_timestamp` (integer)
    Timestamp of the device event, in epoch milliseconds.
    Example: 1777462766771

  - `risk_details.device.timezone` (string)
    Device timezone.
    Example: Asia/Jerusalem

  - `risk_details.device.incognito` (boolean)
    Indicates whether incognito mode was detected.
    Example: false

  - `risk_details.device.tampered` (boolean)
    Indicates whether device tampering was detected.
    Example: false

  - `risk_details.device.emulated` (boolean)
    Indicates whether an emulator was detected.
    Example: false

  - `risk_details.device.spoofed` (boolean)
    Indicates whether device spoofing was detected.
    Example: true

  - `risk_details.device.esim` (boolean)
    Indicates whether eSIM information was detected.
    Example: false

  - `risk_details.network` (object)
    Network risk details collected during the verification flow.

  - `risk_details.network.network_country` (string)
    Country detected from the network.
    Example: IE

  - `risk_details.network.ip_address` (string)
    IP address (IPv4 or IPv6) detected from the network.
    Example: 192.168.1.1

  - `risk_details.network.ip_type` (string)
    Type of IP address detected.
    Example: hosting

  - `risk_details.network.ip_organization` (string)
    Organization associated with the IP address.
    Example: Amazon.com, Inc.

  - `risk_details.network.timezone` (string)
    Timezone detected from the IP address.
    Example: Europe/Dublin

  - `risk_details.network.vpn` (boolean)
    Indicates whether VPN usage was detected.
    Example: false

  - `risk_details.network.tor` (boolean)
    Indicates whether Tor usage was detected.
    Example: false

  - `risk_details.network.proxy` (boolean)
    Indicates whether proxy usage was detected.
    Example: false

  - `risk_details.network.anonymizer` (boolean)
    Indicates whether anonymizer usage was detected.
    Example: false

  - `risk_details.recommendation_reasons` (array)
    Risk signals that contributed to the recommendation.
    Example: ["DEVICE_SPOOFED_BY_USERAGENT","DEVICE_SUSPICIOUS_PLATFORM_OS","DEVICE_VERY_OLD_VERSION","DEVICE_PLATFORM_ANOMALY","DEVICE_IP_TIMEZONE_MISMATCH","IP_RISKY_REPUTATION","DEVICE_NEW"]

  - `person` (object, required)
    Information about the person in this session.

  - `person.full_name` (string)
    Full name
    Example: Marie Salomea Skłodowska-Curies

  - `person.given_name` (string)
    Given name
    Example: Marie

  - `person.surname` (string)
    Family name
    Example: Curies

  - `person.gender` (string)
    Gender
    Enum: "male", "female", "other"

  - `person.national_id` (string)
    The value that identifies this specific person, like an ID number
    Example: 123ABC

  - `person.date_of_birth` (string)
    The person's date of birth, as an ISO-8601 string
    Example: 1867-11-07T00:00:00.000Z

  - `person.age` (number)
    The person's age, at the time the verification was created. This is a derived field and is not present in the original document. It is calculated from the date of birth and the current date.
    Example: 35

  - `document` (object, required)
    Information about the document in this session.

  - `document.country` (string)
    The country that issued this document, as an ISO 3166 alpha-2 code
    Example: US

  - `document.region` (string)
    Sub-division of the document's issuer within the country. For example, this field will contain the issuing state for a US drivers license but will be empty for a US passport. Given as a as an ISO 3166 alpha-2 code
    Example: NY

  - `document.type` (string, required)
    The type of this document
    Enum: "national_id", "drivers_license", "passport", "residence_permit", "visa", "firearm_license", "criminal_police_certificate", "health_card", "membership_card", "postal", "social_security_card", "voter_card", "professional_id", "other"

  - `document.number` (string)
    This value identifies the document and the person attached to it.
    Example: 1234567

  - `document.serial_number` (string)
    This value identifies the document itself and not the person attached to it. This property isn't present on all document types, but when it is, the value will change when a document is renewed or reissued. This value is only meaningful in the context of the specific document's country and type
    Example: 1234567

  - `document.issue_date` (string)
    The date the document was issued, as an ISO-8601 string
    Example: 1867-11-07T00:00:00.000Z

  - `document.expiration_date` (string)
    The date the document is expired, as an ISO-8601 string
    Example: 1867-11-07T00:00:00.000Z

  - `additional_info` (object)
    Additional information extracted from this session.

  - `additional_info.address` (object)
    The person's address

  - `additional_info.address.country` (string)
    ISO 3166-1 alpha-3 country code
    Example: USA

  - `additional_info.address.region` (string)
    Region
    Example: Indiana

  - `additional_info.address.city` (string)
    City
    Example: Indianapolis

  - `additional_info.address.street` (string)
    Street
    Example: Snowy Ridge Road

  - `additional_info.address.house_number` (string)
    House number
    Example: 1234

  - `additional_info.address.apartment_number` (string)
    Apartment number
    Example: 12

  - `additional_info.address.postcode` (string)
    Postcode
    Example: 56789

  - `additional_info.address.full_address` (string)
    Full address
    Example: 1234 Snowy Ridge Road Indianapolis, IN 56789

  - `additional_info.national_status` (object)
    The person's national status

  - `additional_info.national_status.citizen` (boolean)
    Indicates if the person is a citizen of the issuing country

  - `additional_info.national_status.resident` (boolean)
    Indicates if the person is a permanent resident of the issuing country

  - `additional_info.employment` (object)
    The person's employment information

  - `additional_info.employment.profession` (string)
    The person's profession

  - `checks` (object, required)
    The verification checks performed in this session.

  - `checks.document_validation` (object)
    Checks that the data extracted from the document is valid and matches the document template.

  - `checks.document_validation.recommendation` (string, required)
    The recommendation of the check.
    Enum: "ALLOW", "CHALLENGE", "DENY", "N/A"

  - `checks.document_validation.reasons` (array)
    Machine-readable rejection reasons.

  - `checks.document_authentication` (object)
    Checks that the document is authentic and that there are no signs of tampering.

  - `checks.document_authentication.recommendation` (string, required)
    The recommendation of the check.
    Enum: "ALLOW", "CHALLENGE", "DENY", "N/A"

  - `checks.document_authentication.reasons` (array)
    Machine-readable rejection reasons.

  - `checks.document_liveness` (object)
    Checks that the document is a real live document (e.g., not a screen capture).

  - `checks.document_liveness.recommendation` (string, required)
    The recommendation of the check.
    Enum: "ALLOW", "CHALLENGE", "DENY", "N/A"

  - `checks.document_liveness.reasons` (array)
    Machine-readable rejection reasons.

  - `checks.biometric_matching` (object)
    Checks that the selfie is a biometric match to the picture extracted from the document.

  - `checks.biometric_matching.recommendation` (string, required)
    The recommendation of the check.
    Enum: "ALLOW", "CHALLENGE", "DENY", "N/A"

  - `checks.biometric_matching.reasons` (array)
    Machine-readable rejection reasons.

  - `checks.biometric_liveness` (object)
    Checks that the selfie is a real live person (e.g., not a screen capture).

  - `checks.biometric_liveness.recommendation` (string, required)
    The recommendation of the check.
    Enum: "ALLOW", "CHALLENGE", "DENY", "N/A"

  - `checks.biometric_liveness.reasons` (array)
    Machine-readable rejection reasons.

  - `checks.flagged_identity` (object)
    Checks the session against previous sessions identifying suspicious fraudulent behavior (e.g., previous face fraud).

  - `checks.flagged_identity.recommendation` (string, required)
    The recommendation of the check.
    Enum: "ALLOW", "CHALLENGE", "DENY", "N/A"

  - `checks.flagged_identity.reasons` (array)
    Machine-readable rejection reasons.

  - `checks.risk_recommendation` (object)
    Assesses the risk throughout the verification process using a built-in integration with our [Fraud Prevention](/guides/risk/overview) services. This is used to detect risk signals, such as bots, spoofed devices, behavioral anomalies, malicious networks, and more.

  - `checks.risk_recommendation.recommendation` (string, required)
    The recommendation of the check.
    Enum: "ALLOW", "CHALLENGE", "DENY", "N/A"

  - `checks.risk_recommendation.reasons` (array)
    Machine-readable [reasons](/guides/risk/recommendations) forwarded from Fraud Prevention services.

  - `verification_images` (array, required)
    Images used for verification

  - `verification_images.id` (string, required)
    Image ID

  - `verification_images.type` (string, required)
    Image type
    Enum: "document_front", "document_back", "selfie"

  - `recommendation` (string)
    Aggregated result of the verification checks. Returned only if the verification was completed.
See [recommendations](/guides/verify/identity_verification_result/#recommendations)
    Enum: "ALLOW", "CHALLENGE", "DENY"

  - `rejection_description` (array)
    Human-readable description of any issues with this session. Not returned if the recommendation is ALLOW

  - `extracted_info` (object)
    Information extracted from this session, but not guaranteed to be verified. Not returned if the recommendation is ALLOW

  - `extracted_info.document` (object)
    Info extracted from the verification session. Returned only if the verification was completed

  - `extracted_info.document.type` (string, required)
    The type of this document
    Enum: "national_id", "drivers_license", "passport", "residence_permit", "visa", "firearm_license", "criminal_police_certificate", "health_card", "membership_card", "postal", "social_security_card", "voter_card", "professional_id", "other"

  - `extracted_info.document.country` (string)
    The country that issued this document, as an ISO 3166-1 alpha-3 code
    Example: USA

  - `extracted_info.document.region` (string)
    Sub-division of the document's issuer within the country. For example, this field will contain the issuing state for a US drivers license but will be empty for a US passport.
    Example: ny

  - `extracted_info.document.issue_date` (string)
    The date the document was issued, as an ISO-8601 string
    Example: 1867-11-07T00:00:00.000Z

  - `extracted_info.document.document_serial_number` (string)
    A value that identifies this specific document. When an ID (for example) expires and a new one is issued, the 'id_value' will remain the same but this value will be different.
    Example: 1234567

  - `extracted_info.document.id_value` (string)
    The value that identifies this specific person, like an ID number
    Example: 123ABC

  - `extracted_info.document.given_name` (string)
    The person's given name, according to this document
    Example: Marie

  - `extracted_info.document.surname` (string)
    The person's surname, according to this document
    Example: Curie

  - `extracted_info.document.full_name` (string)
    The person's full name, according to this document
    Example: Marie Salomea Skłodowska-Curie

  - `extracted_info.document.date_of_birth` (string)
    The person's date of birth, as an ISO-8601 string
    Example: 1867-11-07T00:00:00.000Z

  - `extracted_info.document.valid_until` (string)
    The date the document is expired, as an ISO-8601 string
    Example: 1867-11-07T00:00:00.000Z

  - `extracted_info.person` (object)
    Information about the person in this session

  - `extracted_info.person.given_name` (string)
    Given name
    Example: Marie

  - `extracted_info.person.surname` (string)
    Family name
    Example: Curie

  - `extracted_info.person.gender` (string)
    Gender
    Example: F

  - `extracted_info.person.full_name` (string)
    Full name
    Example: Marie Salomea Skłodowska-Curies

  - `extracted_info.person.age` (number)
    The person's age, at the current UTC date
    Example: 36

  - `extracted_info.person.address` (object)
    The person's address

  - `extracted_info.person.address.country` (string)
    ISO 3166-1 alpha-3 country code
    Example: USA

  - `extracted_info.person.address.region` (string)
    Region
    Example: Indiana

  - `extracted_info.person.address.city` (string)
    City
    Example: Indianapolis

  - `extracted_info.person.address.street` (string)
    Street
    Example: Snowy Ridge Road

  - `extracted_info.person.address.house_number` (string)
    House number
    Example: 1234

  - `extracted_info.person.address.apartment_number` (string)
    Apartment number
    Example: 12

  - `extracted_info.person.address.postcode` (string)
    Postcode
    Example: 56789

  - `extracted_info.person.address.full_address` (string)
    Full address
    Example: 1234 Snowy Ridge Road Indianapolis, IN 56789

  - `extracted_info.person.date_of_birth` (string)
    The person's date of birth, as an ISO-8601 string
    Example: 1867-11-07T00:00:00.000Z

  - `verified_info` (object)
    Info verified in the verification session. Returned only if the recommendation is ALLOW

  - `verified_info.person` (object)
    Information about the person identified by this session

  - `verified_info.document` (object)
    Information from the documents of this session