GET /v1/racing/horses/backfill/{job_id}

Poll as often as your rate limit allows. `credits_blocked` is the one field worth watching: the worker bills 3 credits per horse as it delivers it, and when your balance drops below that it stops taking rows for your key and leaves them queued. Nothing is lost — collection resumes when your credits reset on the 1st, or immediately if you upgrade.

Request

curl 'https://api.puntersedge.online/v1/racing/horses/backfill/YOUR_JOB_ID' \
  -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 free. Field names and types are as the API returns them; values are a real sample, trimmed to a few items.

{
  "job_id": "bf_20260907_3a9c1e",
  "submitted_at": "2026-09-07T00:52:10Z",
  "total": 38,
  "done": 21,
  "queued": 17,
  "failed": 0,
  "credits_charged": 63,
  "credits_blocked": false,
  "queue_position": 0,
  "estimated_ready": "2026-09-07T01:35:00Z",
  "ready_to_collect": 21
}

Related endpoints

• GET /v1/racing/acceptances — Full-day AU thoroughbred acceptance card: every meeting, race and runner
• GET /v1/racing/best-odds — Best racing price per runner across books
• GET /v1/racing/changes — Races and prices that changed since a timestamp
• GET /v1/racing/events — Upcoming race list
• GET /v1/racing/greyhounds/form — Greyhound form history for one dog
• GET /v1/racing/greyhounds/stats — Greyhound record by track, distance, box or grade
• POST /v1/racing/horses/backfill — Queue a batch of horses for paced form collection
• DELETE /v1/racing/horses/backfill/{job_id} — Cancel the horses a job has not collected yet