This object is returned by the Get Event API when the event type is identity.approved, identity.denied, or identity.disabled.
Object Fields
Unique identifier for this event object
Identifier for the affected identity
The previous summary status of the identity Available options: PENDING, ERROR, APPROVED, DENIED, DISABLED
The new summary status of the identity Available options: PENDING, ERROR, APPROVED, DENIED, DISABLED
Detailed breakdown of the identity’s status at the time of the event, including active controls and outstanding requirements. See Using Status Details for full field descriptions. Identity controls currently applied to the identity.
Outstanding requirements for the identity. Each entry describes a specific pending or failed requirement. The status of the requirement. Available options: PENDING, FAILED
Indicates who must act to resolve the requirement. Not present on MEMBERS type. Available options: PAXOS, CLIENT
Specific error details for developer use only. Do not expose these values directly to end users. Machine-readable error code.
Human-readable description of the error.
{
"id" : "d840cf31-352f-4190-a476-7522bf3eafda" ,
"identity_id" : "4fd025ab-f29f-47e6-a02e-df90a61c7ec9" ,
"old_summary_status" : "APPROVED" ,
"new_summary_status" : "DISABLED" ,
"status_details" : {
"active_controls" : [
{
"id" : "ctrl-001" ,
"type" : "SELL_ONLY" ,
"set_by" : "SET_BY_PAXOS" ,
"is_overridable" : false ,
"reason_code" : "COMPLIANCE_KYC" ,
"reason" : "Prohibited risk rating" ,
"created_at" : "2026-04-10T08:00:00Z"
}
],
"requirements" : [
{
"type" : "KYC_REFRESH" ,
"status" : "FAILED" ,
"awaiting_action_from" : "CLIENT" ,
"errors" : [
{
"code" : "kyc_refresh_overdue" ,
"description" : "KYC refresh has expired."
}
]
},
{
"type" : "SCREENING_CHECK" ,
"status" : "PENDING" ,
"awaiting_action_from" : "PAXOS" ,
"errors" : [
{
"code" : "screening_in_progress" ,
"description" : "Screening check is in progress."
}
]
}
]
}
}