Endpoints

Coverage


curl "https://api.themaverickdata.com/api/v1/coverage"


{
  "states": [
    { "state": "TX", "contacts": 1234567, "last_built": "2026-07-06T00:00:00Z" }
  ],
  "total_contacts": 1234567,
  "state_count": 1
}

Contacts preview


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"


{
  "state": "TX",
  "count": 25,
  "preview_limit": 25,
  "preview_session_cap": 500,
  "next_cursor": "123456",
  "results": [
    {
      "state": "TX",
      "zip5": "78701",
      "std_addr": "100 MAIN ST",
      "first_name": "ALEX",
      "last_name": "OWNER",
      "email": "alex@example.com",
      "email_status": "available",
      "phone": "5551234567",
      "phone_type": "mobile",
      "dnc_flagged": false,
      "quality_label": "Current-owner verified",
      "renewal_month": 8,
      "renewal_basis": "Purchase anniversary"
    }
  ]
}

Contacts count


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


{ "state": "TX", "count": 18422 }

Create 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",
    "columns": ["state", "zip5", "std_addr", "first_name", "last_name", "phone", "phone_type", "dnc_flagged", "quality_label", "renewal_month"]
  }'


{
  "job_id": "00000000-0000-0000-0000-000000000000",
  "status": "pending",
  "credits_reserved": 50000,
  "max_rows": 50000
}

Poll export


curl -H "X-API-Key: $MAVERICK_DATA_API_KEY" \
  "https://api.themaverickdata.com/api/v1/exports/00000000-0000-0000-0000-000000000000"


{
  "job_id": "00000000-0000-0000-0000-000000000000",
  "status": "ready",
  "state": "TX",
  "row_count": 38412,
  "credits_charged": 38412,
  "download_url": "/api/v1/exports/00000000-0000-0000-0000-000000000000/download",
  "expires_at": "2026-07-13T00:00:00Z"
}

Statuses are pending, running, ready, failed, or expired.

Download export


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"

A download returns text/csv when the job is ready and the file exists. A non-ready job returns 409.

Usage


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


{
  "client_id": "org_example",
  "contacts_consumed_this_month": 38412,
  "contacts_per_month_limit": 50000,
  "rate_limit_rpm": 120
}

Me


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


{
  "client_id": "org_example",
  "is_internal": false,
  "allowed_states": ["TX"],
  "rate_limit_rpm": 120
}