API reference · eKYB

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
Was this page helpful?