BINADocs
justbina.com
Esc
  • Try “quote gate”, “bulletin”, or “CLEARY_LLM_MODEL”.
API referenceReference · Information-oriented

Ingest and status

Check coverage and model configuration, start a radar ingest, and follow its run.

#GET/v1/radar/status

Coverage and configuration in one read. Never returns credentials.

FieldDescription
modefixture (sample) or live.
documents, sampleDocumentsStored document counts.
coveragePer authority: documents, date range, full text stored, with recitals.
textStatusesCount per text status (available, not_in_source, unparsed, …).
sourcesActive DG COMP and ADLC snapshots with record count, retrieval time and hash.
suggestedPeriodA month worth opening.
exampleA document with parsed text: documentId, caseNumber, reportPath, extractionPath, textPath.
llmExtraction configuration (configured, provider, model).
watchlist{ active, clientListLoaded }.

#POST/v1/admin/ingest

Start a radar ingest when target is radar.

Body fieldDefaultDescription
targetlistsUse radar. (lists, competition, extra and all load source snapshots.)
from, to—ISO dates; from ≤ to.
textLimit25Commission PDFs to fetch, 1–200.
textstrueFetch decision texts.
pressReleasestrueFetch press releases.

Response 202: { runId, status: "running", statusPath }.

Errors: 400 invalid option, 409 an ingest is running or the server is offline.

#GET/v1/radar/ingest-runs/:runId

FieldDescription
statusrunning, activated, partial or failed.
startedAt, finishedAtTimestamps.
summaryPer-source results; summary.text.remaining is the number of PDFs still queued.
errorSet when failed.

Errors: 404 — no radar ingest with that ID.

#GET/v1/health

Process health: mode, version, radar mode and extraction status, ingest state, webhook stats and OCR availability.

BINA · private enforcement radar. Nothing in these docs is legal advice; BINA does not make legal decisions.