5 min
Getting Started
Make your first API call and enrich a contact in under 5 minutes.
Prerequisites
Before you begin, make sure you have:
- An ABM.dev account (sign up free)
- An API key from your dashboard
1
Get your API key
Navigate to your API Keys page and create a new key. Keep it secure - you'll need it for all API requests.
Security Tip
Store your API key securely. Never commit it to version control or expose it in client-side code.
2
Make your first request
Use the enrichment endpoint to get data about a person or company. Replace YOUR_API_KEY with your actual key.
Enrich a contact
curl -X POST https://api.abm.dev/api/v2/enrichments \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"targets": [
{
"type": "person",
"email": "[email protected]"
}
]
}'Request Fields
targets is an array — enrich up to 3 inline (larger batches return 202 with a job id). Each target's type picks the entity (person or company) and can be just an email, or include extras like first_name, last_name, company, and linked_in_url — more fields, better confidence.3
Explore the response
Every v2 response is wrapped in a { data, actions, meta } envelope. The enriched targets — with confidence scores (0–1) and per-field attribution — live under data.results:
{
"data": {
"id": "enr_abc123",
"status": "completed",
"target_count": 1,
"completed_count": 1,
"failed_count": 0,
"credits_used": 1,
"results": [
{
"target_index": 0,
"status": "completed",
"confidence": 0.92,
"approved": false,
"enrichment": {
"full_name": "Jane Smith",
"title": "VP of Engineering",
"email": "[email protected]",
"linked_in_url": "https://linkedin.com/in/janesmith",
"company_name": "Acme Corp",
"company_domain": "acme.com",
"industry": "Technology"
},
"field_attribution": [
{ "field": "title", "source": "linkedin", "confidence": 0.88 },
{ "field": "company_name", "source": "synthesis", "confidence": 0.99 }
],
"metadata": {
"sources_used": ["linkedin", "hunter", "synthesis"],
"fields_populated": 7
}
}
]
},
"actions": [
{ "rel": "approve", "method": "POST", "href": "/api/v2/enrichments/enr_abc123/approve" }
],
"meta": {
"request_id": "req_01HZX...",
"api_version": "2"
}
}Response fields
data.idUnique identifier for this enrichment requestdata.statusOverall status: completed or partial (per-target status lives in each result)data.results[].enrichmentEnriched person and company fields (snake_case)data.results[].confidenceOverall confidence score (0–1); per-field scores are in field_attributionactionsHypermedia links for the next step (approve, writeback, …)metaRequest metadata — request_id and api_versionWhat's next?
Now that you've made your first enrichment request, explore more features: