Get an event

GET

events

{id}

Get an event

curl --request GET \
  --url https://sandbox-api.infinityapp.in/v1/events/{id} \
  --header 'Authorization: Bearer <token>'

{
  "id": "event_2wq8n5hkd7xm3rpa",
  "type": "payout.paid",
  "created_at": "2026-10-26T10:05:30Z",
  "api_version": "v1",
  "environment": "sandbox",
  "data": {
    "object": {
      "id": "payout_4kz9xq7m2w8dn3ra",
      "batch_id": "batch_fcb4cuwtd6fcbmwr",
      "wallet_id": "wallet_7t4m9k2qx8d3hn5r",
      "payee_id": "payee_c8pnahcrxqzd3z8d",
      "amount": "500.00",
      "currency": "eur",
      "debit_amount": "568.35",
      "debit_currency": "usd",
      "fee": "10.00",
      "fee_bearer": "account",
      "rate": "0.8955",
      "payee_amount": "500.00",
      "payee_currency": "eur",
      "status": "pending",
      "failure_code": null,
      "failure_message": null,
      "hold_expires_at": null,
      "description": "October invoice",
      "reference": "inv-1042",
      "metadata": {
        "invoice": "inv-1042"
      },
      "created_at": "2026-10-26T10:05:00Z",
      "updated_at": "2026-10-26T10:05:00Z"
    }
  }
}

{
  "error": {
    "type": "authentication_error",
    "code": "wrong_environment",
    "message": "This is a live key. Use it on api.infinityapp.in.",
    "param": null,
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_payout_request",
    "message": "amount has more than 2 decimals for eur.",
    "param": "amount",
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_payout_request",
    "message": "amount has more than 2 decimals for eur.",
    "param": "amount",
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_payout_request",
    "message": "amount has more than 2 decimals for eur.",
    "param": "amount",
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_payout_request",
    "message": "amount has more than 2 decimals for eur.",
    "param": "amount",
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

Authorizations

Authorization

string

header

required

Your secret key: sk_test_… on the sandbox host, sk_live_… on live. A key on the wrong host gets a 401 wrong_environment. Keys are secret. Keep them on your server, never in a browser or app.

Path Parameters

string

required

Example:

"event_2wq8n5hkd7xm3rpa"

Response

The event.

Option 1
Option 2
Option 3
Option 4

The start of type says which object data.object is. It's a snapshot from when the event happened.

string

required

Also sent as the webhook-id header.

Example:

"event_2wq8n5hkd7xm3rpa"

type

enum<string>

required

Available options:

payout.created,

payout.updated,

payout.awaiting_funds,

payout.pending,

payout.processing,

payout.paid,

payout.failed,

payout.returned,

payout.canceled,

payout.expired,

batch.created,

batch.processing,

batch.awaiting_funds,

batch.awaiting_payees,

batch.completed,

batch.partially_completed,

batch.failed,

batch.canceled,

payee.created,

payee.details_pending,

payee.verifying,

payee.active,

payee.inactive,

deposit.created

Example:

"payout.paid"

created_at

string<date-time>

required

When the change happened, not when it was delivered.

Example:

"2026-10-26T10:05:30Z"

api_version

enum<string>

required

Available options:

v1

environment

enum<string>

required

Available options:

live,

sandbox

Example:

"sandbox"

data

object

required

Show child attributes

Get an event

curl --request GET \
  --url https://sandbox-api.infinityapp.in/v1/events/{id} \
  --header 'Authorization: Bearer <token>'

{
  "id": "event_2wq8n5hkd7xm3rpa",
  "type": "payout.paid",
  "created_at": "2026-10-26T10:05:30Z",
  "api_version": "v1",
  "environment": "sandbox",
  "data": {
    "object": {
      "id": "payout_4kz9xq7m2w8dn3ra",
      "batch_id": "batch_fcb4cuwtd6fcbmwr",
      "wallet_id": "wallet_7t4m9k2qx8d3hn5r",
      "payee_id": "payee_c8pnahcrxqzd3z8d",
      "amount": "500.00",
      "currency": "eur",
      "debit_amount": "568.35",
      "debit_currency": "usd",
      "fee": "10.00",
      "fee_bearer": "account",
      "rate": "0.8955",
      "payee_amount": "500.00",
      "payee_currency": "eur",
      "status": "pending",
      "failure_code": null,
      "failure_message": null,
      "hold_expires_at": null,
      "description": "October invoice",
      "reference": "inv-1042",
      "metadata": {
        "invoice": "inv-1042"
      },
      "created_at": "2026-10-26T10:05:00Z",
      "updated_at": "2026-10-26T10:05:00Z"
    }
  }
}

{
  "error": {
    "type": "authentication_error",
    "code": "wrong_environment",
    "message": "This is a live key. Use it on api.infinityapp.in.",
    "param": null,
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_payout_request",
    "message": "amount has more than 2 decimals for eur.",
    "param": "amount",
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_payout_request",
    "message": "amount has more than 2 decimals for eur.",
    "param": "amount",
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_payout_request",
    "message": "amount has more than 2 decimals for eur.",
    "param": "amount",
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_payout_request",
    "message": "amount has more than 2 decimals for eur.",
    "param": "amount",
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

Account

Wallets

Funding addresses

Deposits

Currencies

Exchange rates

Payees

Payee addresses

Bank requirements

Quotes

Payouts

Batches

Webhook endpoints

Events

API Reference

Authorizations

Path Parameters

Response