Quickstart

This guide takes you from access to a first export. Counts and previews are free; completed exports spend credits from the selected state.

Dashboard path

Accept the invitation to your organization.
Choose a plan and state slots.
Open the dashboard and select one state.
Add filters such as ZIP, renewal month, homeowner, phone presence, or email presence.
Preview the count and sample rows.
Start an export with the columns you need.
Download the CSV when the export status is ready.

API path

Confirm the API key and allowed states:


curl -H "X-API-Key: $MAVERICK_DATA_API_KEY" \
  "https://api.themaverickdata.com/api/v1/me"

Estimate a filtered audience:


curl -H "X-API-Key: $MAVERICK_DATA_API_KEY" \
  "https://api.themaverickdata.com/api/v1/contacts/count?state=TX&renewal_month=8&has_phone=true"

Preview sample rows:


curl -H "X-API-Key: $MAVERICK_DATA_API_KEY" \
  "https://api.themaverickdata.com/api/v1/contacts?state=TX&renewal_month=8&has_phone=true&limit=25"

Create an export:


curl -X POST "https://api.themaverickdata.com/api/v1/exports" \
  -H "X-API-Key: $MAVERICK_DATA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "state": "TX",
    "max_rows": 50000,
    "idempotency_key": "tx-aug-phone-001",
    "has_phone": true,
    "renewal_month": "8"
  }'

Poll and download:


curl -H "X-API-Key: $MAVERICK_DATA_API_KEY" \
  "https://api.themaverickdata.com/api/v1/exports/00000000-0000-0000-0000-000000000000"
 
curl -L -H "X-API-Key: $MAVERICK_DATA_API_KEY" \
  -o tx-export.csv \
  "https://api.themaverickdata.com/api/v1/exports/00000000-0000-0000-0000-000000000000/download"

Limits to know first

/contacts preview returns up to 25 rows per page and has a 500 row/day preview session cap.
/contacts/count is free and never bills.
A single export request is capped at 50,000 rows.
Exports reserve credits when queued and debit completed row count when ready.