Skip to main content
GET
/
api
/
gateway
/
sharable-payload
/
{pull_token}
Retrieve async verification results
curl --request GET \
  --url https://instance.prod.onboardapp.io/api/gateway/sharable-payload/{pull_token} \
  --header 'X-API-KEY: <api-key>'
{
  "case_reference": "AML-2026-0042",
  "external_reference": "<string>",
  "processing_status": "complete",
  "overall_verdict": "Pass",
  "risk_tier": "High",
  "completed_at": "2023-11-07T05:31:56Z",
  "next_review_date": "2023-12-25",
  "company": {},
  "screening": {},
  "directors": [
    {}
  ],
  "beneficial_owners": [
    {}
  ],
  "identity": {},
  "document": {},
  "biometric": {},
  "risk_assessment": {},
  "checks_summary": {},
  "compliance_metadata": {}
}

Authorizations

X-API-KEY
string
header
required

Project-scoped API key for server-to-server authentication. Obtain keys from the Zenoo dashboard under Project Settings > API Keys. Staging and production environments use separate keys.

Path Parameters

pull_token
string
required

Pull token from the /init response or 202 partial response.

Response

Verification complete. Full compliance report.

Top-level verification result from the pull endpoint or sync response. Contains overall verdict, risk assessment, and detailed check results.

case_reference
string

Zenoo's unique case identifier.

Example:

"AML-2026-0042"

external_reference
string

Your reference ID, echoed back from the request.

processing_status
enum<string>

Current processing state.

Available options:
complete,
processing,
failed
overall_verdict
enum<string>

Aggregated verification outcome.

Available options:
Pass,
Refer,
Fail
risk_tier
enum<string>

Assessed risk level.

Available options:
High,
Medium,
Low
completed_at
string<date-time>

ISO 8601 completion timestamp.

next_review_date
string<date>

Recommended next review date.

company
object

Registry-verified company data (Company Verification only).

screening
object

Screening summary with PEP/sanctions/adverse media status.

directors
object[]

Director screening results (Company Verification only).

beneficial_owners
object[]

UBO screening results (Company Verification only).

identity
object

Identity verification result (Person Verification only).

document
object

Document verification result (Person Verification only).

biometric
object

Biometric liveness result (Person Verification only).

risk_assessment
object

Risk score breakdown.

checks_summary
object

Summary of all checks performed.

compliance_metadata
object

CDD/EDD status and case URL.