curl "https://www.mapsdata.io/api/v1/enrichments/4a982a10-b50e-440d-a4f4-0f6b2af8a965" \
-H "x-api-key: md_live_your_key"
{
"id": "4a982a10-b50e-440d-a4f4-0f6b2af8a965",
"name": "Plumbing companies to enrich",
"status": "enriching",
"source": "provided",
"origin": "api",
"run_id": null,
"error": null,
"lead_count": 2,
"credits_charged": 2,
"enrich_contacts": true,
"enriched_count": 1,
"delete_requested": false,
"actor_input": {
"query": "Standalone enrichment",
"location": "Provided businesses",
"maxResults": 2,
"language": "en",
"businesses": [
{"business_name": "Plumbing NYC", "website_url": "https://www.plumbingnyc.com"},
{"business_name": "A&E NYC Plumbing", "website_url": "https://www.aeplumbingnyc.com"}
]
},
"created_at": "2026-10-01T10:42:00Z",
"finished_at": null
}
Endpoints
Get enrichment status
Read live progress and terminal state for a standalone enrichment job.
GET
/
enrichments
/
{job_id}
curl "https://www.mapsdata.io/api/v1/enrichments/4a982a10-b50e-440d-a4f4-0f6b2af8a965" \
-H "x-api-key: md_live_your_key"
{
"id": "4a982a10-b50e-440d-a4f4-0f6b2af8a965",
"name": "Plumbing companies to enrich",
"status": "enriching",
"source": "provided",
"origin": "api",
"run_id": null,
"error": null,
"lead_count": 2,
"credits_charged": 2,
"enrich_contacts": true,
"enriched_count": 1,
"delete_requested": false,
"actor_input": {
"query": "Standalone enrichment",
"location": "Provided businesses",
"maxResults": 2,
"language": "en",
"businesses": [
{"business_name": "Plumbing NYC", "website_url": "https://www.plumbingnyc.com"},
{"business_name": "A&E NYC Plumbing", "website_url": "https://www.aeplumbingnyc.com"}
]
},
"created_at": "2026-10-01T10:42:00Z",
"finished_at": null
}
Poll every 5–10 seconds until
status is completed or failed. Supplied rows become available from the results endpoint as the import stage commits them, then their enrichment fields update in place.
curl "https://www.mapsdata.io/api/v1/enrichments/4a982a10-b50e-440d-a4f4-0f6b2af8a965" \
-H "x-api-key: md_live_your_key"
{
"id": "4a982a10-b50e-440d-a4f4-0f6b2af8a965",
"name": "Plumbing companies to enrich",
"status": "enriching",
"source": "provided",
"origin": "api",
"run_id": null,
"error": null,
"lead_count": 2,
"credits_charged": 2,
"enrich_contacts": true,
"enriched_count": 1,
"delete_requested": false,
"actor_input": {
"query": "Standalone enrichment",
"location": "Provided businesses",
"maxResults": 2,
"language": "en",
"businesses": [
{"business_name": "Plumbing NYC", "website_url": "https://www.plumbingnyc.com"},
{"business_name": "A&E NYC Plumbing", "website_url": "https://www.aeplumbingnyc.com"}
]
},
"created_at": "2026-10-01T10:42:00Z",
"finished_at": null
}
run_id remains null because standalone enrichment does not start a Google Maps discovery run. enriched_count increases as primary website contact enrichment completes; other result fields may continue changing until the job is terminal.