API reference / Account
GET /v1/account/insightsUsage, request health, projection and upgrade advice
What the console dashboard shows: successful calls and credits per Australia/Sydney day, the endpoints you use most, refused requests grouped by cause (with whose side the cause is on), whether your integration is working, a projection to the next reset (only once there is enough history to make one), and upgrade advice that appears only when your own usage shows a need. Request contents are never stored or returned.
X-API-Key
0 credits
curl 'https://api.puntersedge.online/v1/account/insights' \
-H 'X-API-Key: YOUR_KEY'
| Name | In | Type | Required | Description |
|---|---|---|---|---|
days |
query | integer | no | Days of history for the daily series. |
Status codes: 200, 401, 402, 422, 429, 500. Response bodies are JSON; the full schema is in /openapi.json.
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.
{
"generated_at": "2026-10-22T06:00:00Z",
"days": 7,
"timezone": "Australia/Sydney",
"metered": true,
"plan": "free",
"integration": {
"first_success_at": "2026-10-05T03:46:00Z",
"last_success_at": "2026-10-21T06:00:00Z",
"last_24h": {
"ok": 1,
"customer_errors": 2,
"server_errors": 0
},
"state": "errors",
"basis": "More of your requests were refused than answered in the last 24 hours."
},
"daily": [
{
"date": "2026-10-20",
"ok_calls": 3,
"credits": 135,
"client_errors": {},
"server_errors": 0
},
{
"date": "2026-10-21",
"ok_calls": 3,
"credits": 135,
"client_errors": {},
"server_errors": 0
},
{
"date": "2026-10-22",
"ok_calls": 0,
"credits": 0,
"client_errors": {
"422": 1,
"403": 1
},
"server_errors": 0
}
],
"top_endpoints": [
{
"endpoint": "/v1/racing/next-to-go",
"calls": 22,
"credits": 990
}
],
"errors": [
{
"status": 403,
"endpoint": "/v1/racing/price-history",
"count": 1,
"last_at": "2026-10-22T03:00:00Z",
"guidance_code": "plan_gate",
"side": "yours",
"gate": "price_history_past"
},
{
"status": 422,
"endpoint": "/v1/racing/results",
"count": 1,
"last_at": "2026-10-22T04:00:00Z",
"guidance_code": "validation",
"side": "yours",
"gate": null
}
],
"projection": {
"method": "Two rates are compared: credits used since the start of this period (or since your first successful request, if later) per day, and the last 7 days per day. Each is carried forward to the next reset. When they disagree by more than 2x, or one day holds most of the period's use, a range is shown instead of one number.",
"used": 2400,
"limit": 3000,
"period_start": "2026-10-01T00:00:00Z",
"next_reset": "2026-11-01T00:00:00Z",
"sufficient": true,
"reason": null,
"active_days": 6,
"period_rate_per_day": 140.4,
"trailing_7d_rate_per_day": 115.7,
"projected": 3769,
"projected_low": 3528,
"projected_high": 3769,
"irregular": false,
"exhausts_before_reset": true,
"exhaustion_estimate": "2026-10-26T12:33:30Z"
},
"entitlements": {
"plan": "free",
"held": [],
"grandfathered": []
},
"recommendations": [
{
"id": "credits",
"reason": "credits",
"limitation": "At your current rate your credits run out before the reset.",
"evidence": {
"refused_402": 0,
"projected": 3769,
"projected_high": 3769,
"limit": 3000,
"exhaustion_estimate": "2026-10-26T12:33:30Z"
},
"config_fixes": [
{
"id": "etag",
"text": "Send If-None-Match with the ETag of your last next-to-go response: an unchanged board comes back as 304 and costs 0 credits."
},
{
"id": "poll_interval",
"seconds": 65,
"text": "Poll next-to-go no more often than every 65 seconds: the stored board is refreshed on that cycle for your plan, so faster polls pay again for the same data."
}
],
"resolves": "a larger monthly credit allowance",
"offer": {
"plan": "hobby",
"plan_name": "Hobby",
"price_aud": 9,
"credits_per_month": 7500,
"rpm": 60,
"sales_assisted": false,
"url": "https://puntersedge.online/api/pricing?plan=hobby&utm_source=console&utm_medium=recommendation#plan-hobby",
"covers_projected_need": true
},
"not_included": []
},
{
"id": "gate:price_history_past",
"reason": "plan_gate",
"limitation": "1 request for price history on races that started more than 24 hours ago refused on your plan.",
"resolves": "price history on races that started more than 24 hours ago",
"evidence": {
"refused_403": 1,
"gate": "price_history_past"
},
"config_fixes": [
{
"id": "recent_races",
"text": "Price history on races that started in the last 24 hours stays available on your plan: fetch it while the race is recent."
}
],
"sample": "price_history",
"offer": {
"plan": "racing",
"plan_name": "Standard",
"price_aud": 29,
"credits_per_month": 75000,
"rpm": 200,
"sales_assisted": false,
"url": "https://puntersedge.online/api/pricing?plan=racing&utm_source=console&utm_medium=recommendation#plan-racing"
},
"also_in": [
"Plus",
"Business",
"Platform",
"Scale"
],
"not_included": []
}
],
"overage": null
}
GET /v1/account — Your account: email, plan, password, billing and consent statusGET /v1/account/events — Your account's change historyPOST /v1/account/marketing — Turn promotional emails on or off for your accountGET /v1/account/onboarding — Your onboarding checklistPUT /v1/account/onboarding — Choose your onboarding use casePOST /v1/account/password — Set or change your account passwordGET /v1/account/samples/{kind} — A labelled sample of a plan-gated endpoint's responseGET /v1/billing/overage — Overage: state, rate and ceilingThe free tier needs no credit card, and the sandbox endpoints need no key at all.
Get a free API key Quickstart