Retrieve an Identity Verification Application

Retrieve a submitted Identity Verification (IDV) application.

Endpoint

GET /v1/identity-verifications/{applicationId}

Authorization Header

Authorization: Bearer <access_token>

Path Parameters

applicationId REQUIRED

string (UUID)

ID of the IDV application.

Query Parameters

Request Body

None

Returns

Returns the Identity Verification Application object. This object contains the IDV application details.

SAMPLE RESPONSE

				
					{
  "id": "56de0668-7ae5-4706-8591-cd674c512267",
  "businessAccountId": "dac207b6-eb7b-4080-b786-6e505443e26d",
  "accountId": "93813d7a-b333-4701-8d05-a2b4218da883",
  "identityVerificationProfileId": "kyc-profile-1",
  "firstName": "James",
  "lastName": "Smith",
  "legalName": "",
  "accountType": "INDIVIDUAL_CUSTOMER",
  "latestStatus": "COMPLETED",
  "outcome": "APPROVED",
  "statusHistory": [
    {
      "id": "9972f30f-13eb-414f-8830-f198d5ef29c0",
      "status": "NEW",
      "createdAt": "2023-08-09T21:16:37.250Z",
      "updatedAt": "2023-08-10T21:16:37.250Z",
      "identityVerificationId": "285d8b11-53f2-4bc0-957a-0e63897f1759"
    },
    {...},
    {...}
  ],
  "createdAt": "2023-08-09T21:16:37.250Z",
  "createdBy": {
    "id": "48a64999-3222-496d-b6c4-1c019f1059d6",
    "type": "EMPLOYEE"
  },
  "updatedBy": {
    "id": "48a64999-3222-496d-b6c4-1c019f1059d6",
    "type": "EMPLOYEE"
  },
  "updatedAt": "2023-08-10T21:16:37.250Z",
  "entities": [
    {
      "accountId": "93813d7a-b333-4701-8d05-a2b4218da883",
      "firstName": "James",
      "lastName": "Smith",
      "legalName": "",
      "message": "Invalid phone number",
      "entityType": "INDIVIDUAL_CUSTOMER",
      "status": "COMPLETED",
      "outcome": "APPROVED",
      "outcomeDetails": [
        {
          "outcomeReasons": [
            {
              "name": "Phone match",
              "type": "Fraud check"
            }
          ],
          "tags": [
            "Phone number matched"
          ]
        }
      ],
      "processingSummary": {
        "ADDRESS.CITY": "Chicago",
        "INFO.PRIMARY_PHONE_NUMBER": "123232333",
        "DOCS.PASSPORT": "ef2403f1-e350-4db9-b289-0c1e741be3d1"
      }
    }
  ]
}