Account

Get account usage

Usage and credit summary for the current billing month (or a specific month).

get/v1/account/usage

Request

Query parameters

monthstring

Month in YYYY-MM format. Defaults to the current month.

Response

Account usage summary for the period.

successtrue required
dataobject required

Operation payload. See the example for the exact field structure.

Example response

{
  "success": true,
  "data": {
    "period": "2026-05",
    "total_calls": 142,
    "total_credits_charged": 87,
    "total_overage_usd": 0,
    "plan_source": "dedicated_api",
    "subscription_plan": "API_BUILD",
    "subscription_status": "active",
    "operations": {
      "creator_discovery_search_per_100": {
        "calls": 40,
        "credits_charged": 40,
        "overage_amount_usd": 0
      },
      "profile_enrichment": {
        "calls": 47,
        "credits_charged": 47,
        "overage_amount_usd": 0
      }
    }
  },
  "meta": {
    "request_id": "req_01HXYZ...",
    "trace_id": "4f1d...c2"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.