API overview

This is the API section of docs.civiccontracts.com. For how to use the Civic AI product in the browser, switch to the Help tab or start at the Help introduction. The Civic AI API lets developers and data teams integrate procurement search and intelligence into internal tools, CRMs, and analytics workflows.

What you can do

Endpoint group	What it does
Search contracts	Plain-English search over open federal, state, and local solicitations
Search awards	Browse awarded federal contracts for competitive intel
Manage pipeline	Read pipelines and add, update, or remove pursuits

What you can build

Use case	Example
CRM enrichment	Push matching solicitations into Salesforce or HubSpot
Internal dashboards	Feed award data to a BI tool
Custom Scout	Trigger Slack or Teams notifications on new matches
Research automation	Batch-query vendors and agencies for capture reports

Open data client

For public procurement datasets and experimental endpoints, use our open-source client:

pip install civiccontracts-data

npm install @puremetall/civiccontracts-data

civiccontracts-data on GitHub

Python and TypeScript SDK, examples, and schema docs.

Authentication

API keys belong to your organization and are managed by org admins from Settings → Organization in the Civic AI dashboard. Keys look like civic_… and are shown in full exactly once, at creation. Include the key in the Authorization header (or as X-API-Key):

curl -H "Authorization: Bearer civic_YOUR_API_KEY" \
  "https://api.civiccontracts.com/v1/contracts/search?q=cybersecurity+RFQ"

See Authentication for the full details.

Keep API keys secret. Do not commit them to public repositories or expose them in client-side browser code.

Base URL

https://api.civiccontracts.com/v1

All responses share one envelope:

{ "success": true, "data": { … } }

Errors return success: false with an error message and an appropriate HTTP status (400 invalid input, 401 bad key, 404 not found, 429 rate limited).

Public reference API (no auth)

These endpoints power the Classifications browse pages and are callable without login:

GET /api/classifications
GET /api/classifications/{type}          # naics | psc | nia | nsn
GET /api/classifications/{type}/{code}

Query parameters on list endpoints: q (search), sort (awards | name | code), page, limit. Example:

curl "https://dfh83lqdtngu.cloudfront.net/api/classifications/naics?q=541512&limit=5"

Browse classification codes

Search NAICS, PSC, NIA, and NSN reference tables in the app.

Rate limits and fair use

Requests are limited per API key (currently 120 requests/minute), with standard RateLimit-* headers on every response. Contact support for enterprise throughput, dedicated indexes, or bulk export needs.

Help docs — product how-to guides
Data sources
API product page

Getting started

Endpoints

What you can do

What you can build

Open data client

civiccontracts-data on GitHub

Authentication

Base URL

Public reference API (no auth)

Browse classification codes

Rate limits and fair use

​What you can do

​What you can build

​Open data client

civiccontracts-data on GitHub

​Authentication

​Base URL

​Public reference API (no auth)

Browse classification codes

​Rate limits and fair use

​Related

What you can do

What you can build

Open data client

Authentication

Base URL

Public reference API (no auth)

Rate limits and fair use

Related