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

# Retrieve an event

Get one event with the snapshot of its subject.

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

`data` is the subject as it was when the event happened, not as it is now. `mode` is the mode of the key or session that caused it, which is `live` for every event during the beta, 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://developer.402pay.co/api/errors.md).

Request, cURL:

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

Request, Node.js:

```js
const response = await fetch("https://dash.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://dash.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": 4900,
      "currency": "USD",
      "fee_payer": "business",
      "customer_fee": 0,
      "amount_received": 4900,
      "reporting": {
        "currency": "USD",
        "amount": 4900,
        "fee": 0,
        "transaction_fee": 25,
        "customer_fee": 0,
        "net": 4875
      },
      "fee_rate_bps": 0,
      "method": {
        "rail": "crypto",
        "asset": "USDC",
        "network": "polygon",
        "amount": "49.00",
        "expected_amount": "49.00",
        "overpaid_amount": null,
        "from_address": "0x136e44a2738dea5217e8d6745463d2a9a84d1421",
        "tx_hash": "0xc16a611d90302ba917593ed9743f5e734a556e8d2f35bb0d60a2ca02ac99bb20",
        "explorer_url": "https://polygonscan.com/tx/0xc16a611d90302ba917593ed9743f5e734a556e8d2f35bb0d60a2ca02ac99bb20"
      },
      "settlement": {
        "destination": "wallet",
        "asset": "USDC",
        "network": "polygon",
        "amount": "49.00",
        "wallet_id": "wal_1fIGZOrILmsCO0jw",
        "address": "0x9a3c416D4A81669C01f4515bBDEB93C45d3813fe",
        "tx_hash": "0xc16a611d90302ba917593ed9743f5e734a556e8d2f35bb0d60a2ca02ac99bb20",
        "explorer_url": "https://polygonscan.com/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:13.447Z",
      "created_at": "2026-09-26T21:22:47.038Z",
      "updated_at": "2026-09-26T21:23:13.447Z",
      "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": "polygon"
          }
        },
        {
          "type": "detected",
          "created_at": "2026-09-26T21:23:07.047Z",
          "data": {
            "amount": "49.00",
            "network": "polygon",
            "tx_hash": "0xc16a611d90302ba917593ed9743f5e734a556e8d2f35bb0d60a2ca02ac99bb20"
          }
        },
        {
          "type": "confirmation",
          "created_at": "2026-09-26T21:23:08.647Z",
          "data": {
            "current": 1,
            "required": 4
          }
        },
        {
          "type": "confirmation",
          "created_at": "2026-09-26T21:23:10.247Z",
          "data": {
            "current": 2,
            "required": 4
          }
        },
        {
          "type": "confirmation",
          "created_at": "2026-09-26T21:23:11.847Z",
          "data": {
            "current": 3,
            "required": 4
          }
        },
        {
          "type": "confirmation",
          "created_at": "2026-09-26T21:23:13.447Z",
          "data": {
            "current": 4,
            "required": 4
          }
        },
        {
          "type": "succeeded",
          "created_at": "2026-09-26T21:23:13.447Z",
          "data": null
        }
      ]
    },
    "actor": {
      "kind": "system",
      "id": null,
      "name": null
    },
    "mode": "live",
    "api_version": "v1",
    "created_at": "2026-09-26T21:23:15.256Z"
  }
}
```