---
title: "Get Document Authentication status"
method: GET
path: "/v2/data/{verificationId}/result"
tags: ["Document Authentication"]
---

# Get Document Authentication status

`GET /v2/data/{verificationId}/result`

Use this endpoint to get the [status](https://docs.fourthline.com/docs/docauth-statuses) of a Document Authentication case. <br /><br /><img src="https://files.readme.io/310d4d3-Inline_Caution.svg" align="left" alt="Important" /> **Important:** Before using this endpoint, see the <a href="https://docs.fourthline.com/docs/docauth-integration-api">integration guide</a>.

## Path parameters

- `verificationId` string, required

## Headers

- `Authorization` string, required — The `access_token` returned in your most recent [Create access token](https://docs.fourthline.com/reference/create-access-token) response.

## Response `200`

Document authentication status returned

- union
  - object
    - `hash` string — The hash for the case zipfile.
    - `dataValidationError` object — Information about errors we found while validating the data.
    - `verificationId` string — Our unique identifier for the case. <br /><br />Format: uuid string <br /><br />Example: `790f325a-48c9-4b82-bb53-c0ea128236f0` <br />Validations: uuid format, `verificationId` exists <br />Errors: Format is incorrect or doesn’t exist
    - `verificationStatus` string — The [case status](https://docs.fourthline.com/docs/docauth-statuses).
  - object
    - `hash` string — The hash for the case zipfile.
    - `dataValidationError` object — Information about errors we found while validating the data.
    - `verificationId` string — Our unique identifier for the case. <br /><br />Format: uuid string <br /><br />Example: `790f325a-48c9-4b82-bb53-c0ea128236f0` <br />Validations: uuid format, `verificationId` exists <br />Errors: Format is incorrect or doesn’t exist
    - `processType` string — The case type: `ClientDocumentRenewal`= Document Authentication case
    - `verificationStatus` string — The [case status](https://docs.fourthline.com/docs/docauth-statuses).
    - `message` object
      - `statusCode` integer — The case [status code](https://docs.fourthline.com/docs/docauth-statuses).
      - `description` string — The [status code](https://docs.fourthline.com/docs/biometricauth-statuses) description.
  - object
    - `hash` string — The hash for the case zipfile.
    - `dataValidationError` object — Information about errors we found while validating the data.
      - `existingPreviousDocumentData` object — The error relating to the previous ID document data.
        - `status` string — The [case status](https://docs.fourthline.com/docs/docauth-statuses).
        - `error` string — A human-readable message that explains the error in more detail. <br /><br />Example: "The access token is invalid or has expired"
        - `errorCode` integer — The case [status code](https://docs.fourthline.com/docs/docauth-statuses).
        - `created` string — The error timestamp.
    - `verificationId` string — Our unique identifier for the case. <br /><br />Format: uuid string <br /><br />Example: `790f325a-48c9-4b82-bb53-c0ea128236f0` <br />Validations: uuid format, `verificationId` exists <br />Errors: Format is incorrect or doesn’t exist
    - `processType` string — The case type: `ClientDocumentRenewal`= Document Authentication case
    - `verificationStatus` string — The [case status](https://docs.fourthline.com/docs/docauth-statuses).
  - object
    - `hash` string — The hash for the case zipfile.
    - `data` object
      - `ModifiedDateTime` string — The timestamp for when the data was last modified.
      - `ClientNumberProvider` string — Your unique identifier for the client. <br /><br />Format: No set format <br /><br /> <img src="https://files.readme.io/8eb9022-Inline_Tip.svg" align="left"/>**Tip:** This is the **same** value as your `ClientNumberProvider`.
      - `UserData` object — The client’s <Glossary>identity data</Glossary>.
        - `Document` object — The client’s ID document data.
          - `Person` object — The client’s <Glossary>personal data</Glossary> .
            - `Name` string — The client’s full name. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: John James Smith
            - `Type` string — The type of entity the client is. <br />Enum: <br />• `Legal Entity`: The client is a company or organization with legal rights and obligations. <br />• `Legal Person`: The client is a non-human entity with legal rights and obligations. <br />• `Natural Person`: The client is a living human.
            - `Gender` string — The client’s sex <br /><br />Format: Case sensitive <br />Enum: <br />• `Female`: Female in line with ID document <br />• `Male`: Male in line with ID document <br />• `Other`: ID document contains a value other than `Male` or `Female` <br />• `Unknown`: ID document contains **no** gender field
            - `Initials` string — The client’s initials. <br /><br />Format: Alphabetical characters <br /><br />Example: JCCF
            - `LastName` string — The client’s last name. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: Smith
            - `BirthDate` string — The client’s date of birth. <br /><br />Format: Date YYYY-MM-DD <br /><br />Example: `1960-10-18`= October 18, 1960
            - `FirstName` string — The client’s first name. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: John
            - `MiddleName` string — The client’s middle name(s). <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: James
            - `Nationality` string — The client’s nationality. <br /><br />Format: ISO 3166-1 alpha-3 country code <br /><br />Example: BEL
            - `PlaceOfBirth` string — The city where the client was born. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: Sint-Agatha-Berchem
            - `CountryOfBirth` string — The country where the client was born. <br /><br />Format: ISO 3166-1 alpha-3 <br /><br />Example: BEL
          - `PreviousDocumentData` object — The data from the client’s previous ID document.
            - `FirstName` string — The client’s first name. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: John
            - `LastName` string — The client’s last name. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: Smith
            - `Nationality` string — The client’s nationality. <br /><br />Format: ISO 3166-1 alpha-3 country code <br /><br />Example: BEL
            - `PlaceOfBirth` string — The city where the client was born. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: Sint-Agatha-Berchem
            - `BirthDate` string — The client’s date of birth. <br /><br />Format: Date YYYY-MM-DD <br /><br />Example: `1960-10-18`= October 18, 1960
      - `RiskCategory` string — The risk category.
      - `Analyst` string — The identifier of the Fourthline human agent who processed the case.
    - `dataValidationError` object — Information about errors we found while validating the data.
    - `verificationId` string — Our unique identifier for the case. <br /><br />Format: uuid string <br /><br />Example: `790f325a-48c9-4b82-bb53-c0ea128236f0` <br />Validations: uuid format, `verificationId` exists <br />Errors: Format is incorrect or doesn’t exist
    - `processType` string — The case type: `ClientDocumentRenewal`= Document Authentication case
    - `verificationStatus` string — The [case status](https://docs.fourthline.com/docs/docauth-statuses).
    - `riskInfo` object — The [risk information](https://docs.fourthline.com/docs/risk) for the case.
      - `statusCode` integer — The case [risk code](https://docs.fourthline.com/docs/docauth-statuses#risk-codes).
      - `description` string — The [risk score](https://docs.fourthline.com/docs/docauth-statuses#risk-codes).
  - object
    - `hash` string — The hash for the case zipfile.
    - `data` object
      - `ModifiedDateTime` string — The timestamp for when the data was last modified.
      - `ClientNumberProvider` string — Your unique identifier for the client. <br /><br />Format: No set format <br /><br /> <img src="https://files.readme.io/8eb9022-Inline_Tip.svg" align="left"/>**Tip:** This is the **same** value as your `ClientNumberProvider`.
      - `UserData` object — The client’s <Glossary>identity data</Glossary>.
        - `Document` object — The client’s ID document data.
          - `Person` object — The client’s <Glossary>personal data</Glossary> .
            - `Name` string — The client’s full name. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: John James Smith
            - `Type` string — The type of entity the client is. <br />Enum: <br />• `Legal Entity`: The client is a company or organization with legal rights and obligations. <br />• `Legal Person`: The client is a non-human entity with legal rights and obligations. <br />• `Natural Person`: The client is a living human.
            - `Gender` string — The client’s sex <br /><br />Format: Case sensitive <br />Enum: <br />• `Female`: Female in line with ID document <br />• `Male`: Male in line with ID document <br />• `Other`: ID document contains a value other than `Male` or `Female` <br />• `Unknown`: ID document contains **no** gender field
            - `Initials` string — The client’s initials. <br /><br />Format: Alphabetical characters <br /><br />Example: JCCF
            - `LastName` string — The client’s last name. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: Smith
            - `BirthDate` string — The client’s date of birth. <br /><br />Format: Date YYYY-MM-DD <br /><br />Example: `1960-10-18`= October 18, 1960
            - `FirstName` string — The client’s first name. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: John
            - `MiddleName` string — The client’s middle name(s). <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: James
            - `Nationality` string — The client’s nationality. <br /><br />Format: ISO 3166-1 alpha-3 country code <br /><br />Example: BEL
            - `PlaceOfBirth` string — The city where the client was born. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: Sint-Agatha-Berchem
            - `CountryOfBirth` string — The country where the client was born. <br /><br />Format: ISO 3166-1 alpha-3 <br /><br />Example: BEL
          - `PreviousDocumentData` object — The data from the client’s previous ID document.
            - `FirstName` string — The client’s first name. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: John
            - `LastName` string — The client’s last name. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: Smith
            - `Nationality` string — The client’s nationality. <br /><br />Format: ISO 3166-1 alpha-3 country code <br /><br />Example: BEL
            - `PlaceOfBirth` string — The city where the client was born. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: Sint-Agatha-Berchem
            - `BirthDate` string — The client’s date of birth. <br /><br />Format: Date YYYY-MM-DD <br /><br />Example: `1960-10-18`= October 18, 1960
      - `RiskCategory` string — The risk category.
      - `Analyst` string — The identifier of the Fourthline human agent who processed the case.
    - `dataValidationError` object — Information about errors we found while validating the data.
    - `verificationId` string — Our unique identifier for the case. <br /><br />Format: uuid string <br /><br />Example: `790f325a-48c9-4b82-bb53-c0ea128236f0` <br />Validations: uuid format, `verificationId` exists <br />Errors: Format is incorrect or doesn’t exist
    - `processType` string — The case type: `ClientDocumentRenewal`= Document Authentication case
    - `verificationStatus` string — The [case status](https://docs.fourthline.com/docs/docauth-statuses).
    - `riskInfo` object — The [risk information](https://docs.fourthline.com/docs/risk) for the case.
      - `statusCode` integer — The case [risk code](https://docs.fourthline.com/docs/docauth-statuses#risk-codes).
      - `description` string — The [risk score](https://docs.fourthline.com/docs/docauth-statuses#risk-codes).
  - object
    - `hash` string — The hash for the case zipfile.
    - `data` object
      - `ModifiedDateTime` string — The timestamp for when the data was last modified.
      - `ClientNumberProvider` string — Your unique identifier for the client. <br /><br />Format: No set format <br /><br /> <img src="https://files.readme.io/8eb9022-Inline_Tip.svg" align="left"/>**Tip:** This is the **same** value as your `ClientNumberProvider`.
      - `UserData` object — The client’s <Glossary>identity data</Glossary>.
        - `Document` object — The client’s ID document data.
          - `Person` object — The client’s <Glossary>personal data</Glossary> .
            - `Name` string — The client’s full name. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: John James Smith
            - `Type` string — The type of entity the client is. <br />Enum: <br />• `Legal Entity`: The client is a company or organization with legal rights and obligations. <br />• `Legal Person`: The client is a non-human entity with legal rights and obligations. <br />• `Natural Person`: The client is a living human.
            - `Gender` string — The client’s sex <br /><br />Format: Case sensitive <br />Enum: <br />• `Female`: Female in line with ID document <br />• `Male`: Male in line with ID document <br />• `Other`: ID document contains a value other than `Male` or `Female` <br />• `Unknown`: ID document contains **no** gender field
            - `Initials` string — The client’s initials. <br /><br />Format: Alphabetical characters <br /><br />Example: JCCF
            - `LastName` string — The client’s last name. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: Smith
            - `BirthDate` string — The client’s date of birth. <br /><br />Format: Date YYYY-MM-DD <br /><br />Example: `1960-10-18`= October 18, 1960
            - `FirstName` string — The client’s first name. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: John
            - `MiddleName` string — The client’s middle name(s). <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: James
            - `Nationality` string — The client’s nationality. <br /><br />Format: ISO 3166-1 alpha-3 country code <br /><br />Example: BEL
            - `PlaceOfBirth` string — The city where the client was born. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: Sint-Agatha-Berchem
            - `CountryOfBirth` string — The country where the client was born. <br /><br />Format: ISO 3166-1 alpha-3 <br /><br />Example: BEL
          - `PreviousDocumentData` object — The data from the client’s previous ID document.
            - `FirstName` string — The client’s first name. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: John
            - `LastName` string — The client’s last name. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: Smith
            - `Nationality` string — The client’s nationality. <br /><br />Format: ISO 3166-1 alpha-3 country code <br /><br />Example: BEL
            - `PlaceOfBirth` string — The city where the client was born. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: Sint-Agatha-Berchem
            - `BirthDate` string — The client’s date of birth. <br /><br />Format: Date YYYY-MM-DD <br /><br />Example: `1960-10-18`= October 18, 1960
      - `RiskCategory` string — The risk category.
      - `Analyst` string — The identifier of the Fourthline human agent who processed the case.
    - `dataValidationError` object — Information about errors we found while validating the data.
    - `verificationId` string — Our unique identifier for the case. <br /><br />Format: uuid string <br /><br />Example: `790f325a-48c9-4b82-bb53-c0ea128236f0` <br />Validations: uuid format, `verificationId` exists <br />Errors: Format is incorrect or doesn’t exist
    - `processType` string — The case type: `ClientDocumentRenewal`= Document Authentication case
    - `verificationStatus` string — The [case status](https://docs.fourthline.com/docs/docauth-statuses).
    - `riskInfo` object — The [risk information](https://docs.fourthline.com/docs/risk) for the case.
      - `statusCode` integer — The case [risk code](https://docs.fourthline.com/docs/docauth-statuses#risk-codes).
      - `description` string — The [risk score](https://docs.fourthline.com/docs/docauth-statuses#risk-codes).
  - object
    - `hash` string — The hash for the case zipfile.
    - `data` object
      - `ModifiedDateTime` string — The timestamp for when the data was last modified.
      - `ClientNumberProvider` string — Your unique identifier for the client. <br /><br />Format: No set format <br /><br /> <img src="https://files.readme.io/8eb9022-Inline_Tip.svg" align="left"/>**Tip:** This is the **same** value as your `ClientNumberProvider`.
      - `UserData` object — The client’s <Glossary>identity data</Glossary>.
        - `Document` object — The client’s ID document data.
          - `Person` object — The client’s <Glossary>personal data</Glossary> .
            - `Name` string — The client’s full name. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: John James Smith
            - `Type` string — The type of entity the client is. <br />Enum: <br />• `Legal Entity`: The client is a company or organization with legal rights and obligations. <br />• `Legal Person`: The client is a non-human entity with legal rights and obligations. <br />• `Natural Person`: The client is a living human.
            - `Gender` string — The client’s sex <br /><br />Format: Case sensitive <br />Enum: <br />• `Female`: Female in line with ID document <br />• `Male`: Male in line with ID document <br />• `Other`: ID document contains a value other than `Male` or `Female` <br />• `Unknown`: ID document contains **no** gender field
            - `Initials` string — The client’s initials. <br /><br />Format: Alphabetical characters <br /><br />Example: JCCF
            - `LastName` string — The client’s last name. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: Smith
            - `BirthDate` string — The client’s date of birth. <br /><br />Format: Date YYYY-MM-DD <br /><br />Example: `1960-10-18`= October 18, 1960
            - `FirstName` string — The client’s first name. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: John
            - `MiddleName` string — The client’s middle name(s). <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: James
            - `Nationality` string — The client’s nationality. <br /><br />Format: ISO 3166-1 alpha-3 country code <br /><br />Example: BEL
            - `PlaceOfBirth` string — The city where the client was born. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: Sint-Agatha-Berchem
            - `CountryOfBirth` string — The country where the client was born. <br /><br />Format: ISO 3166-1 alpha-3 <br /><br />Example: BEL
          - `PreviousDocumentData` object — The data from the client’s previous ID document.
            - `FirstName` string — The client’s first name. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: John
            - `LastName` string — The client’s last name. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: Smith
            - `Nationality` string — The client’s nationality. <br /><br />Format: ISO 3166-1 alpha-3 country code <br /><br />Example: BEL
            - `PlaceOfBirth` string — The city where the client was born. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: Sint-Agatha-Berchem
            - `BirthDate` string — The client’s date of birth. <br /><br />Format: Date YYYY-MM-DD <br /><br />Example: `1960-10-18`= October 18, 1960
      - `RiskCategory` string — The risk category.
      - `Analyst` string — The identifier of the Fourthline human agent who processed the case.
    - `dataValidationError` object — Information about errors we found while validating the data.
    - `verificationId` string — Our unique identifier for the case. <br /><br />Format: uuid string <br /><br />Example: `790f325a-48c9-4b82-bb53-c0ea128236f0` <br />Validations: uuid format, `verificationId` exists <br />Errors: Format is incorrect or doesn’t exist
    - `processType` string — The case type: `ClientDocumentRenewal`= Document Authentication case
    - `verificationStatus` string — The [case status](https://docs.fourthline.com/docs/docauth-statuses).
    - `riskInfo` object — The [risk information](https://docs.fourthline.com/docs/risk) for the case.
      - `statusCode` integer — The case [risk code](https://docs.fourthline.com/docs/docauth-statuses#risk-codes).
      - `description` string — The [risk score](https://docs.fourthline.com/docs/docauth-statuses#risk-codes).

---

[API](https://skmtc.net/fourthline/apis/fourthline-apis.md) · [All operations](https://skmtc.net/fourthline/apis/fourthline-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fourthline/fourthline-apis/versions/7991ae7c8383/schema)