> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dojah.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List All Verifications

> Pull every verification for your app. Paginate and filter so you can sync results or build reports.

### Request

```http [GET] theme={null}
{{baseUrl}}/api/v1/kyc/verifications
```

### Header

| Header        | Type   | Description                                                                                         |
| ------------- | ------ | --------------------------------------------------------------------------------------------------- |
| AppId         | string | Create an app to get your app ID on dashboard [here](https://app.dojah.io/developers/configuration) |
| Authorization | string | Private/secret key. Use `<key>` not `Bearer <key>`                                                  |

### Query parameter

| Parameter | Type   | Description                                           | Required |
| --------- | ------ | ----------------------------------------------------- | -------- |
| term      | string | for search with email, reference\_id                  | optional |
| start     | string | Start date filter e.g YYYY-MM-DD                      | optional |
| end       | string | End date filter e.g YYYY-MM-DD                        | optional |
| status    | string | status filter e.g Ongoing, Completed, Pending, Failed | optional |

<Warning>
  All file links (e.g. selfie URLs, document URLs) returned in the response expire within **one hour**. We strongly recommend transferring these documents and images to your own infrastructure as soon as you receive them. If a link expires before you are able to download the file, call the [Get Verification Details by Reference ID](/docs/technical-reference/get-verification-details) endpoint to generate a new link — which will also expire in one hour.
</Warning>

### Response

```json Response theme={null}
{
    "entity": {
        "data": [
            {
                "reference_id": "DJ-479A8E4159",
                "app_id": "64d4ab23b2793b00401a2993",
                "verificationStatus": "Completed",
                "datetime": "2024-07-19 17:06:05",
                "environment": "production",
                "first_name": "JOHN",
                "last_name": "MUSA",
                "middle_name": "DOE",
                "full_name": "JOHN DOE MUSA",
                "business_name": "ANON Enterprises",
                "selfieUrl": "https://dojah-kyc.s3.us-east-2.amazonaws.com/sandbox_kyc_image.png",
                "verificationUrl": "https://app.dojah.io/verifications/bio-data/DJ-479A8E4159"
            },
              {
                "reference_id": "DJ-479A8E4159",
                "app_id": "64d4ab23b2793b00401a2993",
                "verificationStatus": "Completed",
                "datetime": "2024-07-19 17:06:05",
                "environment": "production",
                "first_name": "JOHN",
                "last_name": "MUSA",
                "middle_name": "DOE",
                "full_name": "JOHN DOE MUSA",
                "business_name": "ANON Enterprises",
                "selfieUrl": "https://dojah-kyc.s3.us-east-2.amazonaws.com/sandbox_kyc_image.png",
                "verificationUrl": "https://app.dojah.io/verifications/bio-data/DJ-479A8E4159"
            },
              {
                "reference_id": "DJ-479A8E4159",
                "app_id": "64d4ab23b2793b00401a2993",
                "verificationStatus": "Completed",
                "datetime": "2024-07-19 17:06:05",
                "environment": "production",
                "first_name": "JOHN",
                "last_name": "MUSA",
                "middle_name": "DOE",
                "full_name": "JOHN DOE MUSA",
                "business_name": "ANON Enterprises",
                "selfieUrl": "https://dojah-kyc.s3.us-east-2.amazonaws.com/sandbox_kyc_image.png",
                "verificationUrl": "https://app.dojah.io/verifications/bio-data/DJ-479A8E4159"
            },
              {
                "reference_id": "DJ-479A8E4159",
                "app_id": "64d4ab23b2793b00401a2993",
                "verificationStatus": "Completed",
                "datetime": "2024-07-19 17:06:05",
                "environment": "production",
                "first_name": "JOHN",
                "last_name": "MUSA",
                "middle_name": "DOE",
                "full_name": "JOHN DOE MUSA",
                "business_name": "ANON Enterprises",
                "selfieUrl": "https://dojah-kyc.s3.us-east-2.amazonaws.com/sandbox_kyc_image.png",
                "verificationUrl": "https://app.dojah.io/verifications/bio-data/DJ-479A8E4159"
            },
              {
                "reference_id": "DJ-479A8E4159",
                "app_id": "64d4ab23b2793b00401a2993",
                "verificationStatus": "Completed",
                "datetime": "2024-07-19 17:06:05",
                "environment": "production",
                "first_name": "JOHN",
                "last_name": "MUSA",
                "middle_name": "DOE",
                "full_name": "JOHN DOE MUSA",
                "business_name": "ANON Enterprises",
                "selfieUrl": "https://dojah-kyc.s3.us-east-2.amazonaws.com/sandbox_kyc_image.png",
                "verificationUrl": "https://app.dojah.io/verifications/bio-data/DJ-479A8E4159"
            },
              {
                "reference_id": "DJ-479A8E4159",
                "app_id": "64d4ab23b2793b00401a2993",
                "verificationStatus": "Completed",
                "datetime": "2024-07-19 17:06:05",
                "environment": "production",
                "first_name": "JOHN",
                "last_name": "MUSA",
                "middle_name": "DOE",
                "full_name": "JOHN DOE MUSA",
                "business_name": "ANON Enterprises",
                "selfieUrl": "https://dojah-kyc.s3.us-east-2.amazonaws.com/sandbox_kyc_image.png",
                "verificationUrl": "https://app.dojah.io/verifications/bio-data/DJ-479A8E4159"
            },
              {
                "reference_id": "DJ-479A8E4159",
                "app_id": "64d4ab23b2793b00401a2993",
                "verificationStatus": "Completed",
                "datetime": "2024-07-19 17:06:05",
                "environment": "production",
                "first_name": "JOHN",
                "last_name": "MUSA",
                "middle_name": "DOE",
                "full_name": "JOHN DOE MUSA",
                "business_name": "ANON Enterprises",
                "selfieUrl": "https://dojah-kyc.s3.us-east-2.amazonaws.com/sandbox_kyc_image.png",
                "verificationUrl": "https://app.dojah.io/verifications/bio-data/DJ-479A8E4159"
            },
              {
                "reference_id": "DJ-479A8E4159",
                "app_id": "64d4ab23b2793b00401a2993",
                "verificationStatus": "Completed",
                "datetime": "2024-07-19 17:06:05",
                "environment": "production",
                "first_name": "JOHN",
                "last_name": "MUSA",
                "middle_name": "DOE",
                "full_name": "JOHN DOE MUSA",
                "business_name": "ANON Enterprises",
                "selfieUrl": "https://dojah-kyc.s3.us-east-2.amazonaws.com/sandbox_kyc_image.png",
                "verificationUrl": "https://app.dojah.io/verifications/bio-data/DJ-479A8E4159"
            }
            
        ],
        "meta": {
            "total_count": 107,
            "item_per_page": 10,
            "current_page": 1
        }
    }
}
```

### Response Fields

| Field                             | Type    | Description                                                                 |
| --------------------------------- | ------- | --------------------------------------------------------------------------- |
| entity                            | object  | Contains the response data                                                  |
| entity.data                       | array   | List of verification records                                                |
| entity.data\[].reference\_id      | string  | Unique Dojah reference ID for the verification                              |
| entity.data\[].app\_id            | string  | Your application ID                                                         |
| entity.data\[].verificationStatus | string  | Current status of the verification (e.g., "Completed", "Ongoing", "Failed") |
| entity.data\[].datetime           | string  | Date and time when the verification was created                             |
| entity.data\[].environment        | string  | Environment the verification ran in (e.g., "production", "sandbox")         |
| entity.data\[].first\_name        | string  | First name of the verified individual                                       |
| entity.data\[].last\_name         | string  | Last name of the verified individual                                        |
| entity.data\[].middle\_name       | string  | Middle name of the verified individual                                      |
| entity.data\[].full\_name         | string  | Full name of the verified individual                                        |
| entity.data\[].business\_name     | string  | Business name, if applicable                                                |
| entity.data\[].selfieUrl          | string  | URL of the selfie image captured during verification                        |
| entity.data\[].verificationUrl    | string  | Link to view the verification details on the dashboard                      |
| entity.meta                       | object  | Pagination metadata                                                         |
| entity.meta.total\_count          | integer | Total number of verification records                                        |
| entity.meta.item\_per\_page       | integer | Number of records per page                                                  |
| entity.meta.current\_page         | integer | Current page number                                                         |

### Verification Statuses

These are the possible verification statuses for KYC Widget Webhook Notification Data:

| Status    | Description                                                                    |
| --------- | ------------------------------------------------------------------------------ |
| Ongoing   | The verification process is currently in progress.                             |
| Completed | The verification process has been successfully completed and passed all steps. |
| Pending   | The verification process is awaiting further action.                           |
| Failed    | The verification process was not successful.                                   |
| Abandoned | The verification process was abandoned.                                        |
