# Get Events

This endpoint retrieves a list of events that have occurred for a customer's account, often related to webhook notifications. You can filter events by subscription_id and/or a time range query parameter (after).

It returns a paginated list of Event objects, each containing details about the event and any delivery attempts if it's a webhook event.

Endpoint: GET /api/v1/events/
Version: Version: 5153994b
Security: CodeBearer

## Query parameters:

  - `subscription_id` (any)

  - `cursor` (string)

  - `limit` (integer)

  - `after` (any)

## Response 200 fields (application/json):

  - `prev_page` (any)

  - `next_page` (any)

  - `items` (array, required)

  - `items.event` (any, required) — one of (discriminator: event_type):
    - transfer-request.status.approved:
      - `event_id` (string, required)
      - `timestamp` (string, required)
      - `payload` (object, required)
      - `payload.transfer_request_id` (string, required)
      - `payload.transfer_id` (string, required)
      - `event_type` (string, required)
        Enum: "transfer-request.status.approved", "transfer-request.status.canceled", "transfer-request.status.denied", "transfer-request.status.processed", "transfer-request.status.processing", "transfer-request.status.rejected"
    - transfer-request.status.canceled:
      - `event_id` (string, required)
      - `timestamp` (string, required)
      - `payload` (object, required)
      - `payload.transfer_request_id` (string, required)
      - `payload.transfer_id` (string, required)
      - `event_type` (string, required)
        Enum: same as `event_type` in "transfer-request.status.approved" (6 values)
    - transfer-request.status.denied:
      - `event_id` (string, required)
      - `timestamp` (string, required)
      - `payload` (object, required)
      - `payload.transfer_request_id` (string, required)
      - `payload.transfer_id` (string, required)
      - `event_type` (string, required)
        Enum: same as `event_type` in "transfer-request.status.approved" (6 values)
    - transfer-request.status.processed:
      - `event_id` (string, required)
      - `timestamp` (string, required)
      - `payload` (object, required)
      - `payload.transfer_request_id` (string, required)
      - `payload.transfer_id` (string, required)
      - `event_type` (string, required)
        Enum: same as `event_type` in "transfer-request.status.approved" (6 values)
    - transfer-request.status.processing:
      - `event_id` (string, required)
      - `timestamp` (string, required)
      - `payload` (object, required)
      - `payload.transfer_request_id` (string, required)
      - `payload.transfer_id` (string, required)
      - `event_type` (string, required)
        Enum: same as `event_type` in "transfer-request.status.approved" (6 values)
    - transfer-request.status.rejected:
      - `event_id` (string, required)
      - `timestamp` (string, required)
      - `payload` (object, required)
      - `payload.transfer_request_id` (string, required)
      - `payload.transfer_id` (string, required)
      - `event_type` (string, required)
        Enum: same as `event_type` in "transfer-request.status.approved" (6 values)
    - transfers.on-us.processing:
      - `event_id` (string, required)
      - `timestamp` (string, required)
      - `payload` (object, required)
      - `payload.on_us_id` (string, required)
      - `payload.origin_account_id` (string, required)
      - `payload.destination_account_id` (string, required)
      - `event_type` (string, required)
        Enum: "transfers.on-us.success", "transfers.on-us.processing", "transfers.on-us.rejected"
    - transfers.on-us.received:
      - `event_id` (string, required)
      - `timestamp` (string, required)
      - `payload` (object, required)
      - `payload.on_us_id` (string, required)
      - `payload.receiving_pocket_id` (string, required)
      - `payload.transaction_activity_id` (string, required)
      - `event_type` (string, required)
    - transfers.on-us.rejected:
      - `event_id` (string, required)
      - `timestamp` (string, required)
      - `payload` (object, required)
      - `payload.on_us_id` (string, required)
      - `payload.origin_account_id` (string, required)
      - `payload.destination_account_id` (string, required)
      - `event_type` (string, required)
        Enum: same as `event_type` in "transfers.on-us.processing" (3 values)
    - transfers.on-us.success:
      - `event_id` (string, required)
      - `timestamp` (string, required)
      - `payload` (object, required)
      - `payload.on_us_id` (string, required)
      - `payload.origin_account_id` (string, required)
      - `payload.destination_account_id` (string, required)
      - `event_type` (string, required)
        Enum: same as `event_type` in "transfers.on-us.processing" (3 values)
    - transfers.wire.in.rejected:
      - `event_id` (string, required)
      - `timestamp` (string, required)
      - `payload` (object, required)
      - `payload.jiko_account_id` (string, required)
      - `payload.wire_id` (string, required)
      - `event_type` (string, required)
        Enum: "transfers.wire.in.success", "transfers.wire.in.rejected"
    - transfers.wire.in.success:
      - `event_id` (string, required)
      - `timestamp` (string, required)
      - `payload` (object, required)
      - `payload.jiko_account_id` (string, required)
      - `payload.wire_id` (string, required)
      - `event_type` (string, required)
        Enum: same as `event_type` in "transfers.wire.in.rejected" (2 values)
    - transfers.wire.out.processing:
      - `event_id` (string, required)
      - `timestamp` (string, required)
      - `payload` (object, required)
      - `payload.jiko_account_id` (string, required)
      - `payload.wire_id` (string, required)
      - `payload.state` (string, required)
      - `event_type` (string, required)
        Enum: "transfers.wire.out.success", "transfers.wire.out.processing", "transfers.wire.out.rejected"
    - transfers.wire.out.rejected:
      - `event_id` (string, required)
      - `timestamp` (string, required)
      - `payload` (object, required)
      - `payload.jiko_account_id` (string, required)
      - `payload.wire_id` (string, required)
      - `payload.state` (string, required)
      - `event_type` (string, required)
        Enum: same as `event_type` in "transfers.wire.out.processing" (3 values)
    - transfers.wire.out.success:
      - `event_id` (string, required)
      - `timestamp` (string, required)
      - `payload` (object, required)
      - `payload.jiko_account_id` (string, required)
      - `payload.wire_id` (string, required)
      - `payload.state` (string, required)
      - `event_type` (string, required)
        Enum: same as `event_type` in "transfers.wire.out.processing" (3 values)

  - `items.delivery_attempts` (array, required)

  - `items.delivery_attempts.delivery_attempt_id` (string, required)

  - `items.delivery_attempts.subscription_id` (string, required)

  - `items.delivery_attempts.success` (boolean, required)

  - `items.delivery_attempts.response_code` (integer, required)

  - `items.delivery_attempts.response_message` (any, required)

  - `items.delivery_attempts.called_at` (string, required)

  - `items.object_type` (string, required)

  - `object_type` (string)

## Response 422 fields (application/json):

  - `detail` (array)

  - `detail.loc` (array, required)

  - `detail.msg` (string, required)

  - `detail.type` (string, required)

  - `detail.input` (any)

  - `detail.ctx` (object)