curl "https://www.mapsdata.io/api/v1/businesses/c7a0cc35-23f6-48c8-963a-6ac72481ca70" \
-H "x-api-key: md_live_your_key"
{
"id": "c7a0cc35-23f6-48c8-963a-6ac72481ca70",
"search_id": "c15dbb36-5a56-4720-b1af-b388bcaf78dc",
"position": 1,
"title": "Hudson Plumbing & Heating",
"category": "Plumber",
"address": "221 W 37th St, New York, NY 10018",
"phone": "+12125550184",
"website": "https://hudsonplumbing.example",
"rating": 4.7,
"review_count": 186,
"owner_names": ["Elena Torres"],
"decision_maker_names": [],
"emails": ["service@hudsonplumbing.example"],
"owner_emails": ["elena@hudsonplumbing.example"],
"decision_maker_emails": [],
"email_verification_status": "completed",
"additional_phones": [],
"socials": {"facebooks": [], "instagrams": [], "linkedIns": []}
}
Endpoints
Get a business
Retrieve one complete business record by its result ID.
GET
/
businesses
/
{business_id}
curl "https://www.mapsdata.io/api/v1/businesses/c7a0cc35-23f6-48c8-963a-6ac72481ca70" \
-H "x-api-key: md_live_your_key"
{
"id": "c7a0cc35-23f6-48c8-963a-6ac72481ca70",
"search_id": "c15dbb36-5a56-4720-b1af-b388bcaf78dc",
"position": 1,
"title": "Hudson Plumbing & Heating",
"category": "Plumber",
"address": "221 W 37th St, New York, NY 10018",
"phone": "+12125550184",
"website": "https://hudsonplumbing.example",
"rating": 4.7,
"review_count": 186,
"owner_names": ["Elena Torres"],
"decision_maker_names": [],
"emails": ["service@hudsonplumbing.example"],
"owner_emails": ["elena@hudsonplumbing.example"],
"decision_maker_emails": [],
"email_verification_status": "completed",
"additional_phones": [],
"socials": {"facebooks": [], "instagrams": [], "linkedIns": []}
}
Returns one business from a search or standalone enrichment job. Use the
The endpoint accepts businesses from dashboard, REST API, and MCP jobs as long as the authenticated API key belongs to the same account. See Data fields for the complete response shape.
id from an item returned by a search or enrichment results endpoint.
string
required
Business UUID returned in a result-page item.
curl "https://www.mapsdata.io/api/v1/businesses/c7a0cc35-23f6-48c8-963a-6ac72481ca70" \
-H "x-api-key: md_live_your_key"
{
"id": "c7a0cc35-23f6-48c8-963a-6ac72481ca70",
"search_id": "c15dbb36-5a56-4720-b1af-b388bcaf78dc",
"position": 1,
"title": "Hudson Plumbing & Heating",
"category": "Plumber",
"address": "221 W 37th St, New York, NY 10018",
"phone": "+12125550184",
"website": "https://hudsonplumbing.example",
"rating": 4.7,
"review_count": 186,
"owner_names": ["Elena Torres"],
"decision_maker_names": [],
"emails": ["service@hudsonplumbing.example"],
"owner_emails": ["elena@hudsonplumbing.example"],
"decision_maker_emails": [],
"email_verification_status": "completed",
"additional_phones": [],
"socials": {"facebooks": [], "instagrams": [], "linkedIns": []}
}