Skip to main content
POST
Submit agent customer for verification

Authorizations

Authorization
string
header
required

Bearer token authentication for agent-scoped endpoints. The token is the accessToken returned when redeeming a device code via POST /agents/device-codes/redeem. Agent credentials are user-scoped: all requests are automatically bound to the agent's associated customer and subject to the agent's policy.

Response

Verification status returned

id
string
required

Unique identifier for this verification

Example:

"Verification:019542f5-b3e7-1d02-0000-000000000001"

customerId
string
required

The ID of the customer being verified

Example:

"Customer:019542f5-b3e7-1d02-0000-000000000001"

verificationStatus
enum<string>
required

Current status of the KYC/KYB verification

Available options:
RESOLVE_ERRORS,
PENDING_MANUAL_REVIEW,
IN_PROGRESS,
APPROVED,
REJECTED,
READY_FOR_VERIFICATION
Example:

"RESOLVE_ERRORS"

errors
object[]
required

List of issues preventing verification from proceeding. Empty when verificationStatus is APPROVED or IN_PROGRESS.

createdAt
string<date-time>
required

When this verification was created

Example:

"2025-10-03T12:00:00Z"

updatedAt
string<date-time>

When this verification was last updated

Example:

"2025-10-03T12:00:00Z"