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. Submitted businesses are available from the results endpoint immediately.
string
required
UUID returned by
POST /enrichments.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.