Delivr Data API

Access B2B account and contact enrichment data through the Delivr Data API. Query company information, contact details, and firmographic data to enrich your CRM or marketing automation platform.

What You Can Do

Capability	Description
Contact Enrichment	Get email, phone, job title, and social profiles for contacts
Company Lookup	Find company size, industry, revenue, and technographics
Bulk Queries	Process up to 1,000 records per request

Use Cases

Sales prospecting: Enrich leads with contact details and company info
Marketing segmentation: Filter audiences by company size, industry, or tech stack
Data hygiene: Validate and update stale CRM records

Base URLs

Environment	URL
Production	`https://api.delivr.ai/data/core`
Staging	`https://api-staging.delivr.ai/data/core`

Authentication

The Data API uses two authentication methods:

Method	Use For	Header
JWT Token	User management, protected routes	`Authorization: Bearer <token>`
API Key	Data queries, business endpoints	`X-API-Key: <key>`

Getting Your Credentials

Login to get a JWT token:

curl --request POST \
  --url https://api.delivr.ai/data/core/v1/auth/login \
  --header 'content-type: application/json' \
  --data '{
    "email": "your-email@example.com",
    "password": "your-password"
  }'

Create an API client to get your API key:

curl --request POST \
  --url https://api.delivr.ai/data/core/v1/client \
  --header 'authorization: Bearer YOUR_JWT_TOKEN' \
  --header 'content-type: application/json' \
  --data '{
    "name": "My Data API Client"
  }'

Quick Example: Query Contacts

curl --request POST \
  --url https://api.delivr.ai/data/core/v1/contact/query \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'content-type: application/json' \
  --data '{
    "filters": {
      "company_domain": "example.com"
    },
    "limit": 10
  }'

Contract-Based Quotas

Your API usage is governed by your contract terms:

Limit Type	Example
Hourly	10,000 records
Daily	100,000 records
Monthly	2,000,000 records

Enterprise clients can negotiate custom quotas. Contact sales for details.

Monitoring Your Usage

API responses include usage headers:

X-Records-Used-Hour: 1523
X-Records-Limit-Hour: 10000
X-Records-Used-Day: 45231
X-Records-Limit-Day: 100000
X-Records-Used-Month: 892451
X-Records-Limit-Month: 2000000

Rate Limits

Limit	Value
Requests per second	10
Records per request	1,000

If you exceed limits, you'll receive a 429 Too Many Requests response. Honor the Retry-After header before retrying.

Error Handling

Status	Meaning	Action
400	Bad request	Check request body format
401	Unauthorized	Verify API key or JWT
403	Forbidden	Check your quota/permissions
429	Rate limited	Wait and retry
500	Server error	Retry with exponential backoff

Next Steps

Contact Query API Reference - Full parameter documentation
Company Lookup API Reference - Company enrichment endpoints
Resolution as a Service - Set up visitor tracking