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

# Introduction

> Access cooperative contract and supplier data through the CivicMarketplace Partner API

The CivicMarketplace Partner API gives you read-only access to cooperative purchasing contracts, suppliers, and reference taxonomy data. Use it to integrate contract and supplier information into your own applications, dashboards, and workflows.

<Note>
  Prefer to ask questions in plain English instead of writing code? The [AI
  Connector](/ai-connector/overview) brings the same data into ChatGPT, Claude, and Microsoft
  Copilot — no API key required.
</Note>

## What you can do

<CardGroup cols={2}>
  <Card title="Search contracts" icon="file-contract" href="/api-reference/contracts/list-contracts">
    Query cooperative purchasing contracts by keyword, lead entity, coop, supplier, or city service.
  </Card>

  <Card title="Browse suppliers" icon="building" href="/api-reference/suppliers/list-suppliers">
    Look up supplier details including contact info, location, and associated contracts.
  </Card>

  <Card title="Sync incrementally" icon="arrows-rotate" href="/guides/syncing-data">
    Use cursor pagination and `updated_since` filters to keep your data in sync without full
    re-fetches.
  </Card>

  <Card title="Reference taxonomy" icon="tags" href="/api-reference/taxonomy/list-lead-entities">
    Access lead entities, cooperatives, and city service categories to filter and organize results.
  </Card>
</CardGroup>

## Base URL

All API requests go to:

```
https://prod-api.civicmarketplace.com
```

Sandbox environments are also available:

| Environment    | Base URL                                |
| -------------- | --------------------------------------- |
| **Production** | `https://prod-api.civicmarketplace.com` |
| **UAT**        | `https://uat-api.civicmarketplace.com`  |
| **Dev**        | `https://dev-api.civicmarketplace.com`  |

## Quick example

```bash theme={null}
curl https://prod-api.civicmarketplace.com/v1/contracts?q=IT+consulting&limit=5 \
  -H "Authorization: Bearer cmp_live_YOUR_KEY"
```

```json theme={null}
{
	"data": [
		{
			"id": "ctr_abc123",
			"name": "IT Consulting Services",
			"summary": "Professional IT consulting and advisory services",
			"lead_entity": { "id": "le_xyz", "name": "City of Austin" },
			"coop": { "id": "co_456", "name": "Sourcewell" },
			"suppliers": [
				{
					"id": "sup_789",
					"name": "Acme Tech Solutions",
					"location": "Austin, TX",
					"email": "contracts@acmetech.com"
				}
			],
			"city_services": [{ "id": "cs_101", "name": "Information Technology" }],
			"updated_at": "2026-04-20T14:30:00Z"
		}
	],
	"meta": {
		"next_cursor": "eyJpZCI6MTIzfQ",
		"limit": 5
	}
}
```

<CardGroup cols={2}>
  <Card title="Request access" icon="key" href="/request-access">
    Don't have an API key yet? Apply for partner access.
  </Card>

  <Card title="Get started" icon="rocket" href="/quickstart">
    Already have a key? Make your first API call.
  </Card>
</CardGroup>