GET /v1/account

Your credits, prices and last calls

Free. Your credits left (they never expire), prices, last calls and credit movements.

Cost: Free.

Parameters

No parameters.

Errors

`401`	Missing, unknown or revoked API key.
`429`	Too many requests for this key. Wait Retry-After seconds. Not billed.
`503`	Server busy or a query took too long. Retry. Not billed.

Request

curl -s "https://api.askposeidon.app/v1/account" \
  -H "Authorization: Bearer $POSEIDON_API_KEY"

Response

{
  "data": {
    "key_id": 1,
    "owner": "<your key's label>",
    "created_at": "2026-11-12T18:06:47.539537+00:00",
    "credits": 500,
    "last_calls": [
      {
        "at": "2026-11-12T22:11:37.424394+00:00",
        "endpoint": "filters",
        "units": 0,
        "status": 200,
        "duration_ms": 0
      },
      {
        "at": "2026-11-12T22:11:37.418408+00:00",
        "endpoint": "get_weights",
        "units": 20,
        "status": 200,
        "duration_ms": 8
      }
    ],
    "last_credit_movements": [
      {
        "at": "2026-11-12T22:11:37.418408+00:00",
        "delta": -10,
        "reason": "usage: get_weights",
        "balance_after": 500
      },
      {
        "at": "2026-11-12T22:11:37.395537+00:00",
        "delta": -5,
        "reason": "usage: search_experiments",
        "balance_after": 510
      }
    ],
    "prices_in_credits": {
      "search_winners": {
        "per_call": 5
      },
      "search_experiments": {
        "per_call": 5
      },
      "get_ad": {
        "per_call": 2
      },
      "get_brand": {
        "per_call": 5
      },
      "get_weights": {
        "per_call": 10
      },
      "filters": {
        "per_call": 0
      },
      "account": {
        "per_call": 0
      }
    },
    "credits_expire": false
  },
  "meta": {
    "endpoint": "account",
    "api_version": "1.1.0",
    "credits_charged": 0,
    "credits_left": 500,
    "answered_at": "2026-11-12T22:11:37+00:00",
    "coverage": "Ads delivered in the EU or UK only. The only number of people shown is Meta's EU total reach (eu_reach, \"EU reach (Meta's total)\"), as read on the date shown. Meta publishes no spend or impressions for commercial ads. Countries, ages and genders are shown only as shares of Meta's age x gender breakdown of the same read, never as numbers of people: Meta's breakdown rows do not add up to its EU total (measured 0.93x to 1.10x on 3,820 reads), so a country figure in people would not be a fact."
  }
}