> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paxos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# identity_summary_status_change

> Event object returned for identity status change events

This object is returned by the [Get Event API](/api-reference/endpoints/events/get-event) when the event type is `identity.approved`, `identity.denied`, or `identity.disabled`.

## Object Fields

<ResponseField name="id" type="string" required>
  Unique identifier for this event object
</ResponseField>

<ResponseField name="identity_id" type="string" required>
  Identifier for the affected identity
</ResponseField>

<ResponseField name="old_summary_status" type="string" required>
  The previous summary status of the identity

  **Available options:** `PENDING`, `ERROR`, `APPROVED`, `DENIED`, `DISABLED`
</ResponseField>

<ResponseField name="new_summary_status" type="string" required>
  The new summary status of the identity

  **Available options:** `PENDING`, `ERROR`, `APPROVED`, `DENIED`, `DISABLED`
</ResponseField>

<ResponseField name="status_details" type="object">
  Detailed breakdown of the identity's status at the time of the event, including active controls and outstanding requirements. See [Using Status Details](/guides/identity/using-status-details) for full field descriptions.

  <Expandable title="status_details">
    <ResponseField name="active_controls" type="array">
      Identity controls currently applied to the identity.
    </ResponseField>

    <ResponseField name="requirements" type="array">
      Outstanding requirements for the identity. Each entry describes a specific pending or failed requirement.

      <Expandable title="requirements">
        <ResponseField name="type" type="string">
          The requirement type.
        </ResponseField>

        <ResponseField name="status" type="string">
          The status of the requirement.

          **Available options:** `PENDING`, `FAILED`
        </ResponseField>

        <ResponseField name="awaiting_action_from" type="string">
          Indicates who must act to resolve the requirement. Not present on `MEMBERS` type.

          **Available options:** `PAXOS`, `CLIENT`
        </ResponseField>

        <ResponseField name="errors" type="array">
          Specific error details for developer use only. Do not expose these values directly to end users.

          <Expandable title="errors">
            <ResponseField name="code" type="string">
              Machine-readable error code.
            </ResponseField>

            <ResponseField name="description" type="string">
              Human-readable description of the error.
            </ResponseField>
          </Expandable>
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json Example theme={null}
  {
    "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."
            }
          ]
        }
      ]
    }
  }
  ```
</ResponseExample>