Skip to Content
Product GuideContacts & Exports

Contacts & Exports

Each allowed state has a monthly contact allowance. Allowances refresh on the first day of each month in UTC and do not carry over.

Counts and previews

  • Counts do not use the monthly allowance.
  • API previews return up to 25 rows per page.
  • API previews are limited to 500 rows per organization, state, and UTC day.
  • The dashboard displays at most 50 preview rows.

When the API preview limit is reached, the API returns 429 with preview_cap_exceeded and the UTC reset date. Exports remain available.

Exports

  • Export creation returns a job ID for polling.
  • Completed rows use the selected state’s monthly allowance.
  • Failed exports do not use the monthly allowance.
  • Reusing the same idempotency key for a retry returns the same export job instead of creating another one.
  • Ready files remain downloadable for 72 hours.
  • If a file expires, create another export to generate a new download.

Use GET /api/v1/exports to review export history and continue through older pages with next_cursor.

Product GuideFilters