Skip to main content

​
cURL Examples

Replace mk_live_your_key_here with your actual API key in all examples.

​
Health check (no auth needed)

curl https://api-v1.maverickintelligence.co/v1/health

​
List people

curl -H "X-API-Key: mk_live_your_key_here" \
  "https://api-v1.maverickintelligence.co/v1/people?limit=10"

​
Paginate through people

# First page
curl -H "X-API-Key: mk_live_your_key_here" \
  "https://api-v1.maverickintelligence.co/v1/people?limit=50"

# Next page (use nextCursor from previous response)
curl -H "X-API-Key: mk_live_your_key_here" \
  "https://api-v1.maverickintelligence.co/v1/people?limit=50&cursor=eyJQSy..."

​
Get hot leads only

curl -H "X-API-Key: mk_live_your_key_here" \
  "https://api-v1.maverickintelligence.co/v1/people?hot_leads_only=true"

​
Filter by date

curl -H "X-API-Key: mk_live_your_key_here" \
  "https://api-v1.maverickintelligence.co/v1/people?since=2026-03-01"

​
Get a single person

curl -H "X-API-Key: mk_live_your_key_here" \
  "https://api-v1.maverickintelligence.co/v1/people/abc123"

​
Get person events (includes person summary)

curl -H "X-API-Key: mk_live_your_key_here" \
  "https://api-v1.maverickintelligence.co/v1/people/abc123/events?limit=100"
The response includes a person object at the top level with the person’s name, email, and company — no second API call needed.

​
List companies

curl -H "X-API-Key: mk_live_your_key_here" \
  "https://api-v1.maverickintelligence.co/v1/companies?limit=50"

​
Get a single company

curl -H "X-API-Key: mk_live_your_key_here" \
  "https://api-v1.maverickintelligence.co/v1/companies/xyz789"

​
Get statistics

curl -H "X-API-Key: mk_live_your_key_here" \
  "https://api-v1.maverickintelligence.co/v1/stats"

​
Check rate limit headers

curl -v -H "X-API-Key: mk_live_your_key_here" \
  "https://api-v1.maverickintelligence.co/v1/people?limit=1" 2>&1 | grep -i "x-ratelimit\|retry-after\|x-request-id"