> For the complete index of the 402pay docs, see [llms.txt](https://402pay.co/docs/llms.txt).

# Retrieve an event

Get one event with the snapshot of its subject.

`GET https://api.402pay.co/api/v1/events/{id}`

`data` is the subject as it was when the event happened, not as it is now, so an event stored before October 7, 2026 keeps the integer amounts in minor units it was written with. `mode` is always `live`, and `api_version` is the version of the event's shape. `actor` says who caused it: a person, an API key, a customer at checkout, or `system` when 402pay moved a payment along on its own.

### Path

- `id` (string, required): The event's ID, such as `evt_JxmQNXpkZZN8mpqE`.

### Errors

- 404 `not_found` No event with that ID belongs to your business.
- 403 `permission_denied` The event is about something a restricted key can't read. Events about API keys or the business need a key with full access.

Any request can also fail on its key or its body. See [errors](https://402pay.co/docs/api/errors.md).

Request, cURL:

```bash
curl "https://api.402pay.co/api/v1/events/evt_JxmQNXpkZZN8mpqE" \
  -H "Authorization: Bearer $PAY402_SECRET_KEY"
```

Request, Node.js:

```js
const response = await fetch("https://api.402pay.co/api/v1/events/evt_JxmQNXpkZZN8mpqE", {
  headers: {
    Authorization: `Bearer ${process.env.PAY402_SECRET_KEY}`,
  },
});
const { data } = await response.json();
```

Request, Python:

```python
import os

import requests

response = requests.get(
    "https://api.402pay.co/api/v1/events/evt_JxmQNXpkZZN8mpqE",
    headers={
        "Authorization": f"Bearer {os.environ['PAY402_SECRET_KEY']}",
    },
)
data = response.json()["data"]
```

Response, 200 OK:

```json
{
  "data": {
    "id": "evt_JxmQNXpkZZN8mpqE",
    "kind": "event",
    "type": "payment.succeeded",
    "subject": {
      "kind": "payment",
      "id": "pmt_QI02vLdJGd48hBbg"
    },
    "data": {
      "id": "pmt_QI02vLdJGd48hBbg",
      "kind": "payment",
      "status": "succeeded",
      "amount": "49.00",
      "currency": "USD",
      "fee_payer": "business",
      "customer_fee": "0.00",
      "amount_received": "49.00",
      "reporting": {
        "currency": "USD",
        "amount": "49.00",
        "fee": "0.00",
        "transaction_fee": "0.25",
        "customer_fee": "0.00",
        "net": "48.75"
      },
      "fee_rate_bps": 0,
      "method": {
        "rail": "crypto",
        "asset": "USDC",
        "network": "ethereum",
        "amount": "49.00",
        "expected_amount": "49.00",
        "overpaid_amount": null,
        "from_address": "0x136e44a2738dea5217e8d6745463d2a9a84d1421",
        "tx_hash": "0xc16a611d90302ba917593ed9743f5e734a556e8d2f35bb0d60a2ca02ac99bb20",
        "explorer_url": "https://etherscan.io/tx/0xc16a611d90302ba917593ed9743f5e734a556e8d2f35bb0d60a2ca02ac99bb20"
      },
      "settlement": {
        "destination": "wallet",
        "asset": "USDC",
        "network": "ethereum",
        "amount": "49.00",
        "wallet_id": "wal_1fIGZOrILmsCO0jw",
        "address": "0x9a3c416D4A81669C01f4515bBDEB93C45d3813fe",
        "tx_hash": "0xc16a611d90302ba917593ed9743f5e734a556e8d2f35bb0d60a2ca02ac99bb20",
        "explorer_url": "https://etherscan.io/tx/0xc16a611d90302ba917593ed9743f5e734a556e8d2f35bb0d60a2ca02ac99bb20"
      },
      "customer_id": "cst_gWFWcc7Ga0Pv7LSC",
      "link_id": null,
      "url": "https://checkout.402pay.co/checkout/2jrsrcxv7k",
      "reference": "order_1042",
      "metadata": {
        "order_id": "1042"
      },
      "success_url": "https://example.com/thanks",
      "cancel_url": "https://example.com/cart",
      "expires_at": "2026-09-27T21:22:47.038Z",
      "canceled_at": null,
      "checkout_id": "chk_C5yhPQvPqpYgdDgj",
      "description": "Pro plan, monthly",
      "country": "US",
      "failure_code": null,
      "failure_message": null,
      "confirmed_at": "2026-09-26T21:23:10.247Z",
      "created_at": "2026-09-26T21:22:47.038Z",
      "updated_at": "2026-09-26T21:23:10.247Z",
      "events": [
        {
          "type": "created",
          "created_at": "2026-09-26T21:22:47.038Z",
          "data": null
        },
        {
          "type": "method_selected",
          "created_at": "2026-09-26T21:22:47.047Z",
          "data": {
            "rail": "crypto",
            "asset": "USDC",
            "network": "ethereum"
          }
        },
        {
          "type": "detected",
          "created_at": "2026-09-26T21:23:07.047Z",
          "data": {
            "amount": "49.00",
            "network": "ethereum",
            "tx_hash": "0xc16a611d90302ba917593ed9743f5e734a556e8d2f35bb0d60a2ca02ac99bb20"
          }
        },
        {
          "type": "confirmation",
          "created_at": "2026-09-26T21:23:08.647Z",
          "data": {
            "current": 1,
            "required": 2
          }
        },
        {
          "type": "confirmation",
          "created_at": "2026-09-26T21:23:10.247Z",
          "data": {
            "current": 2,
            "required": 2
          }
        },
        {
          "type": "succeeded",
          "created_at": "2026-09-26T21:23:10.247Z",
          "data": null
        }
      ]
    },
    "actor": {
      "kind": "system",
      "id": null,
      "name": null
    },
    "mode": "live",
    "api_version": "v1",
    "created_at": "2026-09-26T21:23:15.256Z"
  }
}
```