Skip to main content
WEBHOOK

Authorizations

Authorization
string
header
required

JWT bearer token. Include as Authorization: Bearer <token>. See the Authentication guide for how to obtain one.

Body

application/json

Payload delivered when a compliance analysis rejects KYC/KYB data and reverts the account from REVIEWING back to ACTION_REQUIRED. The customer must correct the rejected fields surfaced in requirements.errors before resubmitting for review.

id
string<uuid>
required

Account identifier.

Example:

"a1b2c3d4-5e6f-7890-abcd-ef1234567890"

customerId
string
required

Identifier of the customer that owns the account.

Example:

"c1a2b3c4-d5e6-7890-abcd-ef1234567890"

owner
Individual · object
required

Legal entity that owns the account. Discriminated by ownerType.

atTime
string<date-time>
required

When this event occurred. Distinct from the resource's createdAt — events fire on state transitions, so atTime reflects when the transition happened, not when the underlying resource was first created.

sourceAccountId
string<uuid> | null

Parent account ID for sub-accounts. null for top-level accounts.

Example:

null

Response

200

Acknowledged. Trace Finance considers any 2xx response a successful delivery.