---
title: "Get case status"
method: GET
path: "/v1/verifications/{verificationId}/verificationresult"
tags: ["Identity Verification"]
---
# Get case status
`GET /v1/verifications/{verificationId}/verificationresult`
Use this endpoint to get the [status](https://docs.fourthline.com/docs/idv-statuses) of an Identity Verification case.
## 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.
- `Cache-Control` string
## Response `200`
Case status returned
- union
- object
- `verificationId` string — The unique identifier for the Identity Verification case.
Format: uuid string
Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`
**Tip:** This is the **same** value as the `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response.
- `verificationStatus` string — The [case status](https://docs.fourthline.com/docs/idv-statuses).
- `dataValidationError` object — Information about errors we found while validating the data.
- object
- `verificationId` string — The unique identifier for the Identity Verification case.
Format: uuid string
Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`
**Tip:** This is the **same** value as the `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response.
- `processType` string — The case type: `NaturalPersons`: Identity Verification case
- `verificationStatus` string — The [case status](https://docs.fourthline.com/docs/idv-statuses).
- `message` object — Information about the case [status code](https://docs.fourthline.com/docs/idv-statuses#status-codes).
- `statusCode` integer — The case [status code](https://docs.fourthline.com/docs/idv-statuses#status-codes).
- `description` string — The [status code](https://docs.fourthline.com/docs/idv-statuses) description.
- `dataValidationError` object — Information about errors we found while validating the data.
- `prop1` object — Information about the first property containing a data validation error.
- `status` string — The status of the property.
- `error` string — A human-readable message that explains the error in more detail.
Example: "The access token is invalid or has expired"
- `errorCode` integer — The error code relating to the property.
- `created` string — The error timestamp.
- `prop2` object — Information about the second property containing a data validation error.
- `status` string — The status of the property.
- `error` string — A human-readable message that explains the error in more detail.
Example: "The access token is invalid or has expired"
- `errorCode` integer — The error code relating to the property.
- `created` string — The error timestamp.
- `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.
Format: No set format
**Tip:** This is the **same** value as your `ClientNumberProvider`.
- `UserData` object — The client’s identity data.
- `Analyst` string — The identifier of the Fourthline human agent who processed the case.
- `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/idv-statuses#risk-codes).
- `description` string — The [risk score](https://docs.fourthline.com/docs/idv-statuses#risk-codes).
- object
- `verificationId` string — The unique identifier for the Identity Verification case.
Format: uuid string
Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`
**Tip:** This is the **same** value as the `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response.
- `hash` string — The hash for the case zipfile.
- `verificationStatus` string — The [case status](https://docs.fourthline.com/docs/idv-statuses).
- `data` object
- `ModifiedDateTime` string — The timestamp for when the data was last modified.
- `ClientNumberProvider` string — Your unique identifier for the client.
Format: No set format
**Tip:** This is the **same** value as your `providerClientId`.
- `UserData` object — The client’s identity data.
- `Document` object — The client’s ID document data.
- `Tax` object — Information about errors relating to the client’s tax details.
- `TIN` string — The client’s TIN.
Example: 12.34.56-789.01
Other possible values:
• N/A: We **can’t** verify this TIN.
• [NOT PROVIDED]: The TIN **wasn’t** provided.
• Empty: The TIN **isn’t** available.
- `UsTIN` string — The client’s US TIN.
Format: 123-45-6789
- `UsPerson` string — Whether the client is a US citizen
Enum:
• `no`
• `yes`
- `CountrySubjectToTaxation` string — The country where the client is subject to taxation.
Format: ISO 3166-1 alpha-3
- `Person` object — The client’s personal data .
- `Name` string — The client’s full name.
Format: Alphabetical characters, spaces, hyphens, and apostrophes
Example: John James Smith
- `Type` string — The type of entity the client is.
Enum:
• `Legal Entity`: The client is a company or organization with legal rights and obligations.
• `Legal Person`: The client is a non-human entity with legal rights and obligations.
• `Natural Person`: The client is a living human.
- `Gender` string — The client’s sex
Format: Case sensitive
Enum:
• `Female`: Female in line with ID document
• `Male`: Male in line with ID document
• `Other`: ID document contains a value other than `Male` or `Female`
• `Unknown`: ID document contains **no** gender field
- `Initials` string — The client’s initials.
Format: Alphabetical characters
Example: JCCF
- `LastName` string — The client’s last name.
Format: Alphabetical characters, spaces, hyphens, and apostrophes
Example: Smith
- `BirthDate` string — The client’s date of birth.
Format: Date YYYY-MM-DD
Example: `1960-10-18`= October 18, 1960
- `FirstName` string — The client’s first name.
Format: Alphabetical characters, spaces, hyphens, and apostrophes
Example: John
- `MiddleName` string — The client’s middle name(s).
Format: Alphabetical characters, spaces, hyphens, and apostrophes
Example: James
- `Nationality` string — The client’s nationality.
Format: ISO 3166-1 alpha-3 country code
Example: BEL
- `PlaceOfBirth` string — The city where the client was born.
Format: Alphabetical characters, spaces, hyphens, and apostrophes
Example: Sint-Agatha-Berchem
- `CountryOfBirth` string — The country where the client was born.
Format: ISO 3166-1 alpha-3
Example: BEL
- `Address` object — The client’s address details.
- `City` string — The city of the client’s address.
Format: Alphabetical characters, spaces, hyphens, and apostrophes
Example: `London`
- `Region` string — The region of the client’s address
Format: Alphabetical characters, spaces, hyphens, and apostrophes
Example: Brussels Capital Region
- `Street` string — The street of the client’s address.
Format: Alphabetical characters, spaces, hyphens, and apostrophes
Example: Rue Jean-Baptiste Jansen
- `Country` string — The country of the client’s address.
Format: ISO 3166-1 alpha-3
Example: BEL
- `PostalCode` string — The zip code of the client’s address.
Format: Alphabetical characters, spaces, hyphens, and apostrophes
Example: `NW1 6XE`
- `StreetNumber` integer — The street number of the client’s address.
Format: int32 greater than or equal to zero
- `StreetNumberSuffix` string — The suffix of the street number.
Format: Alphabetical characters, spaces, hyphens, and numerals
Example: 123A
- `Profession` object — The client’s profession and employment situation.
- `Industry` string — The industry the client works in.
Enum:
• `A`: Agriculture, forestry, and fishing
• `B`: Mining and quarrying
• `C`: Manufacturing
• `D`: Electricity, gas, stream, and air conditioning supply
• `E`: Water supply; sewerage, waste management and remediation activities
• `F`: Construction
• `G`: Wholesale and retail trade; repair of motor vehicles and motorcycles
• `H`: Transportation and storage
• `I`: Accommodation and food service activities
• `J`: Information and communication
• `K`: Financial and insurance activities
• `L`: Real estate activities
• `M`: Professional, scientific and technical activities
• `N`: Administrative and support service activities
• `O`: Public administration and defense; compulsory social security
• `P`: Education
• `Q`: Human health and social work activities
• `R`: Arts, entertainment and recreation
• `S`: Other service activities
• `T`: Activities of households as employers; undifferentiated goods and services-producing activities
• `U`: Activities of extraterritorial organizations and bodies
- `Employment` string — The client’s employment status. The client’s employment status.
Enum:
• `No`: The client **isn’t** employed.
• `Self Employed`: The client is self-employed.
• `Yes`: The client is employed.
- `Profession` string — The client’s profession.
- `EmailAndPhone` object — The client’s email address and phone number(s).
- `Email` string — The client’s email address.
Format: Maximum 254 characters [_-a-zA-Z0-9.+]+@a-zA-Z0-9
Example: `j.smith@example.com`
- `Phone` string — The client’s landline number.
Format: Must include the country code and begin with `00` or `+` **without** spaces
Example: 003281123456 **or** +3281123456
- `Mobile` string — The client’s mobile phone number.
Format: Must include the country code and begin with `00` or `+` **without** spaces
Example: `00324123456789` **or** `+324123456789`
- `RiskCategory` string — The risk category.
- `Analyst` string — The identifier of the Fourthline human agent who processed the case.
- `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/idv-statuses#risk-codes).
- `description` string — The [risk score](https://docs.fourthline.com/docs/idv-statuses#risk-codes).
- `dataValidationError` object — Information about errors we found while validating the data.
- object
- `verificationId` string — The unique identifier for the Identity Verification case.
Format: uuid string
Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`
**Tip:** This is the **same** value as the `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response.
- `hash` string — The hash for the case zipfile.
- `verificationStatus` string — The [case status](https://docs.fourthline.com/docs/idv-statuses).
- `dataValidationError` object — Information about errors we found while validating the data.
- `ageOver18` object — Information about errors related to the client’s age.
- `status` string — The error status.
- `error` string — A human-readable message that explains the error in more detail.
Example: "The access token is invalid or has expired"
- `errorCode` integer — The case [status code](https://docs.fourthline.com/docs/idv-statuses#status-codes).
- `created` string — The error timestamp.
- object
- `verificationId` string — The unique identifier for the Identity Verification case.
Format: uuid string
Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`
**Tip:** This is the **same** value as the `workflowId` returned in the [Create workflow](https://docs.fourthline.com/reference/create-workflow) response.
- `hash` string — The hash for the case zipfile.
- `verificationStatus` string — The [case status](https://docs.fourthline.com/docs/idv-statuses).
- `data` object
- `ModifiedDateTime` string — The timestamp for when the data was last modified.
- `ClientNumberProvider` string — Your unique identifier for the client.
Format: No set format
**Tip:** This is the **same** value as your `providerClientId`.
- `UserData` object — The client’s identity data.
- `Device` object — Information about the client’s device.
- `DeviceMetaData` object — The metadata of the client’s device.
- `IpAddress` string — The IP address of the client’s device.
Example: 185.128.27.102
- `Document` object — The client’s ID document data.
- `Tax` object — Information about errors relating to the client’s tax details.
- `TIN` string — The client’s TIN.
Example: 12.34.56-789.01
Other possible values:
• N/A: We **can’t** verify this TIN.
• [NOT PROVIDED]: The TIN **wasn’t** provided.
• Empty: The TIN **isn’t** available.
- `UsTIN` string — The client’s US TIN.
Format: 123-45-6789
- `UsPerson` string — Whether the client is a US citizen
Enum:
• `no`
• `yes`
- `CountrySubjectToTaxation` string — The country where the client is subject to taxation.
Format: ISO 3166-1 alpha-3
- `Person` object — The client’s personal data .
- `Name` string — The client’s full name.
Format: Alphabetical characters, spaces, hyphens, and apostrophes
Example: John James Smith
- `Type` string — The type of entity the client is.
Enum:
• `Legal Entity`: The client is a company or organization with legal rights and obligations.
• `Legal Person`: The client is a non-human entity with legal rights and obligations.
• `Natural Person`: The client is a living human.
- `Gender` string — The client’s sex
Format: Case sensitive
Enum:
• `Female`: Female in line with ID document
• `Male`: Male in line with ID document
• `Other`: ID document contains a value other than `Male` or `Female`
• `Unknown`: ID document contains **no** gender field
- `Initials` string — The client’s initials.
Format: Alphabetical characters
Example: JCCF
- `LastName` string — The client’s last name.
Format: Alphabetical characters, spaces, hyphens, and apostrophes
Example: Smith
- `BirthDate` string — The client’s date of birth.
Format: Date YYYY-MM-DD
Example: `1960-10-18`= October 18, 1960
- `FirstName` string — The client’s first name.
Format: Alphabetical characters, spaces, hyphens, and apostrophes
Example: John
- `MiddleName` string — The client’s middle name(s).
Format: Alphabetical characters, spaces, hyphens, and apostrophes
Example: James
- `Nationality` string — The client’s nationality.
Format: ISO 3166-1 alpha-3 country code
Example: BEL
- `PlaceOfBirth` string — The city where the client was born.
Format: Alphabetical characters, spaces, hyphens, and apostrophes
Example: Sint-Agatha-Berchem
- `CountryOfBirth` string — The country where the client was born.
Format: ISO 3166-1 alpha-3
Example: BEL
- `Address` object — The client’s address details.
- `City` string — The city of the client’s address.
Format: Alphabetical characters, spaces, hyphens, and apostrophes
Example: `London`
- `Region` string — The region of the client’s address
Format: Alphabetical characters, spaces, hyphens, and apostrophes
Example: Brussels Capital Region
- `Street` string — The street of the client’s address.
Format: Alphabetical characters, spaces, hyphens, and apostrophes
Example: Rue Jean-Baptiste Jansen
- `Country` string — The country of the client’s address.
Format: ISO 3166-1 alpha-3
Example: BEL
- `PostalCode` string — The zip code of the client’s address.
Format: Alphabetical characters, spaces, hyphens, and apostrophes
Example: `NW1 6XE`
- `StreetNumber` integer — The street number of the client’s address.
Format: int32 greater than or equal to zero
- `StreetNumberPrefix` string — The prefix of the street number
Example: A1
- `StreetNumberSuffix` string — The suffix of the street number.
Format: Alphabetical characters, spaces, hyphens, and numerals
Example: 123A
- `Profession` object — The client’s profession and employment situation.
- `Industry` string — The industry the client works in.
Enum:
• `A`: Agriculture, forestry, and fishing
• `B`: Mining and quarrying
• `C`: Manufacturing
• `D`: Electricity, gas, stream, and air conditioning supply
• `E`: Water supply; sewerage, waste management and remediation activities
• `F`: Construction
• `G`: Wholesale and retail trade; repair of motor vehicles and motorcycles
• `H`: Transportation and storage
• `I`: Accommodation and food service activities
• `J`: Information and communication
• `K`: Financial and insurance activities
• `L`: Real estate activities
• `M`: Professional, scientific and technical activities
• `N`: Administrative and support service activities
• `O`: Public administration and defense; compulsory social security
• `P`: Education
• `Q`: Human health and social work activities
• `R`: Arts, entertainment and recreation
• `S`: Other service activities
• `T`: Activities of households as employers; undifferentiated goods and services-producing activities
• `U`: Activities of extraterritorial organizations and bodies
- `Employment` string — The client’s employment status. The client’s employment status.
Enum:
• `No`: The client **isn’t** employed.
• `Self Employed`: The client is self-employed.
• `Yes`: The client is employed.
- `Profession` string — The client’s profession.
- `EmailAndPhone` object — The client’s email address and phone number(s).
- `Email` string — The client’s email address.
Format: Maximum 254 characters [_-a-zA-Z0-9.+]+@a-zA-Z0-9
Example: `j.smith@example.com`
- `Phone` string — The client’s landline number.
Format: Must include the country code and begin with `00` or `+` **without** spaces
Example: 003281123456 **or** +3281123456
- `Mobile` string — The client’s mobile phone number.
Format: Must include the country code and begin with `00` or `+` **without** spaces
Example: `00324123456789` **or** `+324123456789`
- `RiskCategory` string — The risk category.
- `Analyst` string — The identifier of the Fourthline human agent who processed the case.
- `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/idv-statuses#risk-codes).
- `description` string — The [risk score](https://docs.fourthline.com/docs/idv-statuses#risk-codes).
- `dataValidationError` object — Information about errors we found while validating the data.
## Other responses
- `400` — Invalid request parameters
- `404` — Verification case not found
- `422` — The request could not be processed
- `500` — Unexpected server error
---
[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)