Skip to main content
GET
/
api
/
v1
/
events
/
{eventId}
Retrieve a single event by id
curl --request GET \
  --url https://api-beta.pepay.io/api/v1/events/{eventId} \
  --header 'x-api-key: <api-key>'
{
  "success": true,
  "data": {
    "id": "evt_1700000000000-123",
    "object": "event",
    "api_version": "2025-12-16",
    "created": 1700000000,
    "type": "invoice.updated",
    "livemode": false,
    "pending_webhooks": 0,
    "request": {
      "id": "<string>",
      "idempotency_key": "<string>"
    },
    "data": {
      "object": {
        "object": "invoice",
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "merchant_id": 123,
        "status": "paid",
        "invoice_type": "standard",
        "currency": "usd",
        "amount": 10000,
        "amount_decimal": "10.000",
        "amount_paid": 10000,
        "amount_paid_decimal": "10.000",
        "amount_remaining": 0,
        "amount_remaining_decimal": "0.000",
        "amount_unit": "usd_millis",
        "customer_id": "<string>",
        "payer_wallet_address": "<string>",
        "payer_wallet_network": "<string>",
        "commerce_order_id": "<string>",
        "environment": "devnet",
        "expires_at": "2023-11-07T05:31:56Z",
        "created_at": "2023-11-07T05:31:56Z",
        "paid_at": "2023-11-07T05:31:56Z",
        "last_payment_at": "2023-11-07T05:31:56Z",
        "metadata": {}
      },
      "previous_attributes": {}
    }
  }
}

Authorizations

x-api-key
string
header
required

API key for server-to-server operations (scope=merchant or commerce)

Path Parameters

eventId
string
required

Response

200 - application/json

Event

success
boolean
Example:

true

data
object

Canonical Pepay event envelope (shared across webhooks + websocket event_v1 streams).