Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.civicmarketplace.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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.