Quickstart

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"

const response = await fetch("https://prod-api.civicmarketplace.com/v1/contracts?limit=3", {
	headers: {
		Authorization: "Bearer cmp_live_YOUR_KEY",
	},
});
const data = await response.json();
console.log(data);

import requests

response = requests.get(
    "https://prod-api.civicmarketplace.com/v1/contracts",
    params={"limit": 3},
    headers={"Authorization": "Bearer cmp_live_YOUR_KEY"},
)
print(response.json())

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.

Request API Access Authentication

Get Started

AI Connector (MCP)

Core Concepts

Guides

About

Overview

Contracts

Suppliers

Taxonomy

1. Get your API key

2. Make your first request

3. Explore the data

4. Next steps

Authentication

Pagination

Filtering & search

Syncing data

​1. Get your API key

​2. Make your first request

​3. Explore the data

​4. Next steps

Authentication

Pagination

Filtering & search

Syncing data

1. Get your API key

2. Make your first request

3. Explore the data

4. Next steps