GET /v1/widgets

Every widget on this account, with how many times each has been filled (`fills_total`, exact per widget) and what widgets have cost this ACCOUNT so far this billing period (`credits_this_period`, the account total — usage_logs is keyed by key and endpoint, so a per-widget split of the spend does not exist).

Request

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

Parameters

This endpoint takes no parameters beyond authentication.

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.

{
  "widgets": [
    {
      "widget_id": "wgt_3f9a1c74e20b6d58",
      "label": "Form guide sidebar",
      "active": true,
      "created_at": "2026-09-11T05:22:40Z",
      "last_served_at": "2026-09-25T00:03:12Z",
      "fills_total": 48211
    }
  ],
  "credits_this_period": 4821,
  "credits_this_period_scope": "account",
  "max_widgets": 10,
  "csp": "frame-src https://puntersedge.online"
}

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