curl "https://www.mapsdata.io/api/v1/enrichments/4a982a10-b50e-440d-a4f4-0f6b2af8a965/results?page=1&page_size=500" \
-H "x-api-key: md_live_your_key"
{
"job_id": "4a982a10-b50e-440d-a4f4-0f6b2af8a965",
"status": "enriching",
"items": [
{
"id": "c7a0cc35-23f6-48c8-963a-6ac72481ca70",
"search_id": "4a982a10-b50e-440d-a4f4-0f6b2af8a965",
"position": 1,
"rank": 1,
"title": "Plumbing NYC",
"website": "https://www.plumbingnyc.com",
"owner_names": ["Example Owner"],
"decision_maker_names": [],
"emails": ["service@plumbingnyc.com"],
"owner_emails": [],
"decision_maker_emails": [],
"email_verification_status": "processing",
"email_verifications": {},
"socials": {"facebooks": [], "instagrams": [], "linkedIns": []},
"additional_phones": [],
"phone_types": {},
"enrichment_status": "completed",
"owner_enrichment_status": "completed",
"key_contacts": []
}
],
"total": 2,
"page": 1,
"page_size": 500,
"has_more": false
}
Endpoints
Get enrichment results
Read supplied businesses and their live enrichment fields.
GET
/
enrichments
/
{job_id}
/
results
curl "https://www.mapsdata.io/api/v1/enrichments/4a982a10-b50e-440d-a4f4-0f6b2af8a965/results?page=1&page_size=500" \
-H "x-api-key: md_live_your_key"
{
"job_id": "4a982a10-b50e-440d-a4f4-0f6b2af8a965",
"status": "enriching",
"items": [
{
"id": "c7a0cc35-23f6-48c8-963a-6ac72481ca70",
"search_id": "4a982a10-b50e-440d-a4f4-0f6b2af8a965",
"position": 1,
"rank": 1,
"title": "Plumbing NYC",
"website": "https://www.plumbingnyc.com",
"owner_names": ["Example Owner"],
"decision_maker_names": [],
"emails": ["service@plumbingnyc.com"],
"owner_emails": [],
"decision_maker_emails": [],
"email_verification_status": "processing",
"email_verifications": {},
"socials": {"facebooks": [], "instagrams": [], "linkedIns": []},
"additional_phones": [],
"phone_types": {},
"enrichment_status": "completed",
"owner_enrichment_status": "completed",
"key_contacts": []
}
],
"total": 2,
"page": 1,
"page_size": 500,
"has_more": false
}
Returns supplied businesses as the import stage commits them. Contact, owner, social, phone, and verification fields continue updating while
Fetch all pages again after the job becomes terminal. See Data fields for the complete business shape and verification guidance.
status is enriching.
curl "https://www.mapsdata.io/api/v1/enrichments/4a982a10-b50e-440d-a4f4-0f6b2af8a965/results?page=1&page_size=500" \
-H "x-api-key: md_live_your_key"
{
"job_id": "4a982a10-b50e-440d-a4f4-0f6b2af8a965",
"status": "enriching",
"items": [
{
"id": "c7a0cc35-23f6-48c8-963a-6ac72481ca70",
"search_id": "4a982a10-b50e-440d-a4f4-0f6b2af8a965",
"position": 1,
"rank": 1,
"title": "Plumbing NYC",
"website": "https://www.plumbingnyc.com",
"owner_names": ["Example Owner"],
"decision_maker_names": [],
"emails": ["service@plumbingnyc.com"],
"owner_emails": [],
"decision_maker_emails": [],
"email_verification_status": "processing",
"email_verifications": {},
"socials": {"facebooks": [], "instagrams": [], "linkedIns": []},
"additional_phones": [],
"phone_types": {},
"enrichment_status": "completed",
"owner_enrichment_status": "completed",
"key_contacts": []
}
],
"total": 2,
"page": 1,
"page_size": 500,
"has_more": false
}
Continue the enrichment workflow
- Check whether the job is terminal with
GET /enrichments/{job_id}. - Retrieve other jobs owned by the account with
GET /enrichments. - Submit another batch with
POST /enrichments.
