Skip to main content
This object is returned by the Get Event API when the event type is identity.approved, identity.denied, or identity.disabled.

Object Fields

id
string
required
Unique identifier for this event object
identity_id
string
required
Identifier for the affected identity
old_summary_status
string
required
The previous summary status of the identityAvailable options: PENDING, ERROR, APPROVED, DENIED, DISABLED
new_summary_status
string
required
The new summary status of the identityAvailable options: PENDING, ERROR, APPROVED, DENIED, DISABLED
status_details
object
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.
{
  "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."
          }
        ]
      }
    ]
  }
}