1. Get your API key
Request access if you don’t have a key yet, or contact your CivicMarketplace account manager.
You’ll receive a key in this format:
cmp_live_aBcDeFgH.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Keep your API key secret. Do not commit it to version control or expose it in client-side code.
2. Make your first request
Test your key by listing contracts:
curl https://prod-api.civicmarketplace.com/v1/contracts?limit=3 \
-H "Authorization: Bearer cmp_live_YOUR_KEY"
3. Explore the data
A successful response looks like this:
{
"data": [
{
"id": "ctr_abc123",
"name": "Office Supplies Contract",
"summary": "Competitively bid office supplies agreement",
"lead_entity": { "id": "le_001", "name": "City of Houston" },
"coop": { "id": "co_002", "name": "TIPS" },
"suppliers": [{ "id": "sup_003", "name": "Office Depot", "location": "Boca Raton, FL" }],
"city_services": [{ "id": "cs_004", "name": "General Government" }],
"updated_at": "2026-04-15T09:00:00Z"
}
],
"meta": {
"next_cursor": "eyJpZCI6NDV9",
"limit": 3
}
}
4. Next steps
Authentication
Learn about API key scoping and environments.
Pagination
Page through large result sets with cursors.
Filtering & search
Narrow results by keyword, entity, and date.
Syncing data
Keep a local copy of contracts up to date.
