GET
/
events
List events.
curl --request GET \
  --url https://sandbox.api.openfx.com/v1/events \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Signature: <api-key>' \
  --header 'X-Timestamp: <api-key>'
{
  "items": [
    {
      "id": "evt_01953e1a5f4b7009",
      "type": "payment.completed",
      "data": {
        "resourceType": "payment",
        "resourceId": "pmt_01953e1a5f4b7005",
        "snapshot": {
          "id": "pmt_01953e1a5f4b7005",
          "status": "completed",
          "rail": "swift",
          "sendAmount": {
            "currency": "USD",
            "amount": "10000.00"
          },
          "createdAt": "2026-02-23T12:00:00Z",
          "updatedAt": "2026-02-23T12:05:00Z"
        }
      },
      "createdAt": "2026-02-23T12:05:00Z"
    }
  ],
  "pagination": {
    "hasMore": true,
    "nextCursor": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

API key issued at onboarding. Passed as a Bearer token in the Authorization header: Authorization: Bearer <api-key>. Identifies the caller and determines organization scope. Invalid or revoked keys return 401 with error type authentication_error.

​
X-Signature
string
header
required

Ed25519 or RSA-SHA256 asymmetric signature over the request payload (ADR-0015). Provides request integrity and non-repudiation. The signature covers the HTTP method, path, query string, request body, and timestamp. Invalid signatures return 401 with error type authentication_error.

​
X-Timestamp
string
header
required

Unix timestamp (seconds) of when the request was signed. Server rejects requests where the timestamp drifts beyond +/-60 seconds from server time to prevent replay attacks. Must match the timestamp used in the signature computation.

Query Parameters

​
limit
integer
default:50

Maximum number of items to return. Default 50, max 200.

Required range: 1 <= x <= 200
​
starting_after
string

Cursor for forward pagination. Return items created after the item with this ID. Mutually exclusive with ending_before.

​
ending_before
string

Cursor for backward pagination. Return items created before the item with this ID. Mutually exclusive with starting_after.

​
createdAt[gte]
string<date-time>

Filter items created at or after this timestamp.

Example:

"2026-01-01T00:00:00Z"

​
createdAt[lte]
string<date-time>

Filter items created at or before this timestamp.

Example:

"2026-12-31T23:59:59Z"

​
type
enum<string>

Filter by event type. Type of event. Namespaced as resource.action.

Available options:
entity.created,
entity.updated,
entity_relationship.created,
entity_relationship.deleted,
customer.created,
customer.status_changed,
customer.kyb_status_changed,
account.created,
account.status_changed,
account_number.created,
account_number.status_changed,
blockchain_address.created,
counterparty.created,
counterparty.activated,
counterparty.archived,
payment_method.created,
payment_method.validated,
payment_method.rejected,
payment.created,
payment.requires_action,
payment.in_review,
payment.processing,
payment.completed,
payment.returned,
payment.reversed,
payment.refunded,
payment.failed,
payment.canceled,
inbound_payment.received,
inbound_payment.completed,
inbound_payment.returned,
inbound_payment.requires_attribution,
conversion.created,
conversion.processing,
conversion.completed,
conversion.failed,
transfer.created,
transfer.completed,
transfer.failed,
transaction.created,
refund.created,
refund.completed,
refund.failed,
onboarding.created,
onboarding.completed,
onboarding.failed,
collection.created,
collection.requires_action,
collection.submitted,
collection.processing,
collection.completed,
collection.returned,
collection.failed,
collection.canceled,
settlement_route.created,
settlement_route.activated,
settlement_route.deactivated,
settlement_route.updated,
settlement_route.executed

Response

Event list.

​
items
object[]
required
​
pagination
object
required

Cursor-based pagination metadata. Returned on all list endpoints.