Endpoints

All endpoints on this page require X-API-Key.

Me


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


{
  "client_id": "org_example",
  "allowed_states": ["TX"]
}

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 }

Contacts preview


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

The API returns up to 25 rows per page. Pass next_cursor as cursor to request the next page. Preview usage is limited to 500 rows per organization, state, and UTC day.


{
  "state": "TX",
  "count": 1,
  "next_cursor": "123456",
  "results": [
    {
      "first_name": "Alex",
      "last_name": "Owner",
      "std_addr": "100 Main St",
      "unit": "Apt 4B",
      "city": "Austin",
      "state": "TX",
      "zip5": "78701",
      "zip4": "1234",
      "phone": "(512) 555-0100",
      "dnc": "Not checked",
      "cell": "(737) 555-0101",
      "dnc_cell": "Not flagged",
      "phone_2": "(512) 555-0102",
      "dnc_phone_2": "Flagged",
      "email": "alex@example.com",
      "homeowner": "true",
      "dob": "03/09/1985",
      "age": 41,
      "x_date": "08/14/2026",
      "home_value_est": "500000",
      "property_type": "Single Family Residence"
    }
  ]
}

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,
    "zip5": "78701,78702"
  }'


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

Use a unique idempotency_key for each intended export. If a request is retried with the same key, the API returns the same job.

List exports

GET /api/v1/exports returns your newest export jobs first. limit controls page size. Pass a returned next_cursor as cursor for the next page.


curl -H "X-API-Key: $MAVERICK_DATA_API_KEY" \
  "https://api.themaverickdata.com/api/v1/exports?limit=25"


{
  "count": 1,
  "limit": 25,
  "results": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "state": "TX",
      "status": "ready",
      "row_count": 38412,
      "created_at": "2026-07-12T12:00:00Z",
      "completed_at": "2026-07-12T12:03:00Z",
      "expires_at": "2026-07-15T12:03:00Z",
      "download_path": "/api/v1/exports/00000000-0000-0000-0000-000000000000/download",
      "filename": "maverick-data-tx.csv"
    }
  ],
  "next_cursor": null
}

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,
  "download_url": "/api/v1/exports/00000000-0000-0000-0000-000000000000/download",
  "expires_at": "2026-07-15T12:03:00Z"
}

Statuses are pending, running, ready, failed, and 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"

Downloads are available when a job is ready and expire 72 hours after completion. A job that is not ready returns 409; an expired download returns 410.

Usage


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


{
  "client_id": "org_example",
  "rate_limit_rpm": 120,
  "allowed_states": ["TX"],
  "states": [
    {
      "state": "TX",
      "allowance": 50000,
      "consumed": 38412,
      "remaining": 11588,
      "reset_date": "2026-08-01"
    }
  ]
}

Each entry in states shows that state’s monthly allowance, completed export rows consumed, rows remaining, and UTC reset date. State allowances are independent: usage in one state does not reduce another state’s remaining amount.