Bulk data export

Stream a full licensed dataset as CSV with a single request. Base URL: https://commonelements.com/api/v1/export

Overview

The export endpoint returns the same public-safe data as the corresponding list endpoints, but streams every matching row as a CSV file instead of a paginated JSON page. It reuses your existing API key, scopes, and monthly quota. One export counts as one request against your monthly limit, not one per row.

Exports are streamed and capped per tier, so the largest datasets download as a file rather than buffering in memory. Use the filters to scope an export to a state or category before downloading.

Requirements

Bulk export requires a Growth plan or higher. Builder keys include per-row API access; upgrade to Growth to stream full datasets as CSV. Your key must also carry the read scope for the resource you are exporting.

Tier	Bulk export cap
Free	Not available
Builder	Not available
Growth	50,000 rows / export
Scale	250,000 rows / export
Enterprise	1,000,000 rows / export

An export that reaches the cap returns a complete, valid CSV truncated at the row limit. For larger pulls, filter by state or contact us about enterprise limits.

Resources

Associations

GET /api/v1/export/associations

Scope: associations
Filters: state, subtype (hoa | condo | coop)
Columns: id, name, state, subtype, unit_count, address, city, zip, external_document_number, is_claimed, created_at

Vendors

GET /api/v1/export/vendors

Scope: vendors.read
Filters: state, category (vendor category slug)
Columns: id, name, subtype, city, state, zip, website, verification_status, service_states, directory_slug, review_count, review_avg_rating, follower_count, description, service_categories, service_counties, license_number, insurance_carrier, year_established, team_size

Statutes

GET /api/v1/export/statutes

Scope: statutes (or associations)
Filters: state (required), chapter, topic
Columns: id, chapter_number, chapter_title, section_number, subsection, slug, title, summary, topics, citation, effective_date, source_url

Endpoint contract

Send a GET with your bearer key. The response is text/csv as a file attachment. Only format=csv is supported today.

curl -H "Authorization: Bearer ce_live_your_key_here" \
  "https://commonelements.com/api/v1/export/vendors?state=FL&format=csv" \
  -o vendors.csv

Try it

Paste an API key to download directly in your browser. The key is used only for this request and is never stored.

Resource

State

Two-letter code. Optional filter.

Subtype

API key

Used only for this download. Never stored or sent anywhere else.

curl -H "Authorization: Bearer ce_live_your_key_here" \
  "https://commonelements.com/api/v1/export/associations?format=csv" \
  -o associations.csv

Error cases

Status	Meaning
401	Missing or invalid API key.
403	Key lacks the resource scope, or the plan is below Growth (bulk export not included).
404	Unknown export resource.
400	Invalid filter (for example, a missing state on statutes).
429	Monthly request quota exceeded.

Need the full API reference?

Authentication, endpoints, rate limits, and error codes.

Read the docs