Filtering & Search

The API supports filtering by related entities and full-text keyword search across contracts and suppliers.

Text search

Use the q parameter to search by keyword (max 200 characters):

# Search contracts
curl "https://prod-api.civicmarketplace.com/v1/contracts?q=office+supplies" \
  -H "Authorization: Bearer cmp_live_YOUR_KEY"

# Search suppliers
curl "https://prod-api.civicmarketplace.com/v1/suppliers?q=Acme" \
  -H "Authorization: Bearer cmp_live_YOUR_KEY"

Filtering contracts

Contracts can be filtered by their related entities using opaque IDs:

Parameter	Description	Example
`lead_entity`	Filter by lead entity	`?lead_entity=le_abc123`
`coop`	Filter by cooperative	`?coop=co_def456`
`supplier`	Filter by supplier	`?supplier=sup_ghi789`
`city_service`	Filter by city service category	`?city_service=cs_jkl012`

Getting filter IDs

Use the taxonomy endpoints to look up valid IDs:

# List all lead entities
curl "https://prod-api.civicmarketplace.com/v1/lead-entities" \
  -H "Authorization: Bearer cmp_live_YOUR_KEY"

# List all cooperatives
curl "https://prod-api.civicmarketplace.com/v1/coops" \
  -H "Authorization: Bearer cmp_live_YOUR_KEY"

# List all city services
curl "https://prod-api.civicmarketplace.com/v1/city-services" \
  -H "Authorization: Bearer cmp_live_YOUR_KEY"

Combining filters

You can combine filters with search and date ranges:

# Contracts from a specific coop, updated in the last week, matching "consulting"
curl "https://prod-api.civicmarketplace.com/v1/contracts?coop=co_def456&q=consulting&updated_since=2026-04-15T00:00:00Z" \
  -H "Authorization: Bearer cmp_live_YOUR_KEY"

Date filtering

Use updated_since (ISO 8601 format) to get records modified after a specific time:

# Contracts updated after April 1, 2026
curl "https://prod-api.civicmarketplace.com/v1/contracts?updated_since=2026-04-01T00:00:00Z" \
  -H "Authorization: Bearer cmp_live_YOUR_KEY"

Combine updated_since with cursor pagination for efficient incremental syncing. See the Syncing Data guide.

Get Started

AI Connector (MCP)

Core Concepts

Guides

About

Overview

Contracts

Suppliers

Taxonomy

Text search

Filtering contracts

Getting filter IDs

Combining filters

Date filtering

​Text search

​Filtering contracts

​Getting filter IDs

​Combining filters

​Date filtering

Text search

Filtering contracts

Getting filter IDs

Combining filters

Date filtering