GET /v1/account/events

Every recorded change to this account's plan, credits, keys and switches, newest first: who made it (a billing event, you in the console or with your key, our support team, or a scheduled job), what it was, and the account's state before and after. A primary key sees its own history and its team keys'; a team key sees its own. Key material, password and email are never part of a row. The IP whitelist appears as a count of rules, not the addresses.

Request

curl 'https://api.puntersedge.online/v1/account/events' \
  -H 'X-API-Key: YOUR_KEY'

Parameters

Responses

Status codes: 200, 401, 402, 422, 429, 500. Response bodies are JSON; the full schema is in /openapi.json.

Example response

200 application/json — this call costs 0 credits. Field names and types are as the API returns them; values are a real sample, trimmed to a few items.

{
  "available": true,
  "count": 2,
  "events": [
    {
      "action": "plan_change",
      "actor": "stripe",
      "after": {
        "active": true,
        "credits_used": 18210,
        "ip_whitelist": 0,
        "overage_enabled": true,
        "plan": "pro_plus"
      },
      "api_key_id": "3f1c9a52-7d0e-4b8a-9c61-2e5f0d8b7a14",
      "at": "2026-10-13T04:12:09.512331+00:00",
      "before": {
        "active": true,
        "credits_used": 18210,
        "ip_whitelist": 0,
        "overage_enabled": false,
        "plan": "plus"
      },
      "id": 1042,
      "request_id": "evt_1Q2w3E4r5T6y7U8i9O0p",
      "source": "stripe:customer.subscription.updated"
    },
    {
      "action": "key_rotate",
      "actor": "console",
      "api_key_id": "3f1c9a52-7d0e-4b8a-9c61-2e5f0d8b7a14",
      "at": "2026-10-02T22:40:51.004912+00:00",
      "id": 977,
      "note": "key_version 2",
      "request_id": "6b0d8f3e-21c4-4a9e-b7d2-5e8c1a0f9b33",
      "source": "POST /v1/keys/rotate"
    }
  ]
}

Related endpoints

• GET /v1/account — Your account: email, plan, password, billing and consent status
• POST /v1/account/marketing — Turn promotional emails on or off for your account
• POST /v1/account/password — Set or change your account password
• GET /v1/billing/overage — Overage: state, rate and ceiling
• POST /v1/billing/overage — Switch overage on or off
• GET /v1/billing/portal — Self-service billing portal link
• POST /v1/billing/portal — Billing portal link (console; confirms your password)
• GET /v1/billing/upgrade-link — A signed link to your prorated upgrade page