---
title: "Get async vendor verification status/result"
url: "https://developer.incode.com/api-reference/verification-async-referenceid/"
section: "api-reference"
group: "eKYB"
version: "v1.1"
status: "live"
endpoint: "GET /omni/verification/async/{referenceId}"
---
# Get async vendor verification status/result

`GET /omni/verification/async/{referenceId}`

Base URL: `https://demo-api.incodesmile.com` — Incode demo environment

Retrieves the status and persisted result of a previously initiated async vendor
verification request. The result field is null while the request is PENDING,
carries the verification response body once COMPLETED, and carries error details
when FAILED. The result is also delivered via the corresponding webhook
(EKYB_VERIFICATION_RESULT / EKYC_VERIFICATION_RESULT); this endpoint is a
read-only status check. Returns 404 if the referenceId is not found or belongs
to a different tenant.

## Path & query parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `referenceId` | path | string | yes |  |
| `api-version` | header | string | yes |  |

## Responses

### 200

Request found — status is PENDING, COMPLETED, or FAILED

Response body (`application/json`):

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `referenceId` | string |  |  |
| `status` | string |  | Enum: `PENDING`, `COMPLETED`, `FAILED` |
| `type` | string |  | Enum: `EKYB`, `EKYC` |
| `result` | object |  |  |

### 404

No async verification request found for the given referenceId

Response body (`application/json`):

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `referenceId` | string |  |  |
| `status` | string |  | Enum: `PENDING`, `COMPLETED`, `FAILED` |
| `type` | string |  | Enum: `EKYB`, `EKYC` |
| `result` | object |  |  |

## Code samples

Generated from this endpoint's method, path, and the conventional Incode headers. The base URL is the Incode demo environment; replace `<YOUR_API_KEY>` with a key for your region.

### cURL

```bash
curl -X GET https://demo-api.incodesmile.com/omni/verification/async/{referenceId} \
  -H "x-api-key: <YOUR_API_KEY>" \
  -H "api-version: 1.0"
```

### Node

```js
const res = await fetch("https://demo-api.incodesmile.com/omni/verification/async/{referenceId}", {
  method: "GET",
  headers: {
      "x-api-key": "<YOUR_API_KEY>",
      "api-version": "1.0",
  },
});
const data = await res.json();
```

### Python

```python
import requests

headers = {
    "x-api-key": "<YOUR_API_KEY>",
    "api-version": "1.0",
}
res = requests.get("https://demo-api.incodesmile.com/omni/verification/async/{referenceId}", headers=headers)
data = res.json()
```

### Java

```java
HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://demo-api.incodesmile.com/omni/verification/async/{referenceId}"))
    .header("x-api-key", "<YOUR_API_KEY>")
    .header("api-version", "1.0")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
HttpResponse<String> res = HttpClient.newHttpClient()
    .send(req, HttpResponse.BodyHandlers.ofString());
```

### Example response

```json
{
  "success": true,
  "status": "OK"
}
```