REST API Reference

OpenContract provides public REST endpoints for researchers, civil society, and oversight agencies.

GET/api/v1/procurements

List procurements with pagination, status filtering, and search query.

Example Request:/api/v1/procurements?page=1&pageSize=10

GET/api/v1/procurements/:ocid

Fetch full procurement dossier by OCID, including awards, contracts, and integrity signals.

Example Request:/api/v1/procurements/ocds-demo-2026-000001

GET/api/v1/procurements/:ocid/timeline

Export the full chronological event timeline of a procurement in structured JSON.

Example Request:/api/v1/procurements/ocds-demo-2026-000001/timeline

GET/api/v1/ocds/records/:ocid

Export the procurement record strictly in standard Open Contracting Data Standard 1.1 format.

Example Request:/api/v1/ocds/records/ocds-demo-2026-000001

POST/api/v1/verify/document

Verify a document by SHA-256 fingerprint. Returns verification outcome, registered record, and blockchain anchor status.

Request Body:{ "sha256": "a3f2b4c8d1e5f9a0b2c4d6e8f0a2b4c6d8e0f2a4b6c8d0e2f4a6b8c0d2e4f6a8" }

POST/api/v1/analyst

Ask the grounded AI procurement analyst questions backed by Google Gemini and live database records.

Request Body:{ "question": "What is the status of the Tema Motorway Upgrade?" }