Get one of your leads
Returns a single lead this account owns, in the same shape the list returns. A lead belonging to someone else is 404, not 403 — a 403 would confirm the id is real. Free. Requires the leads:read scope when called with a scoped key.
/v1/leads/{id}Returns a single lead this account owns, in the same shape the list returns. A lead belonging to someone else is 404, not 403 — a 403 would confirm the id is real. Free. Requires the leads:read scope when called with a scoped key.
Pass Authorization: Bearer mapleads_xxx.
In: header
Path Parameters
Lead id.
Response Body
application/json
curl -X GET "https://example.com/v1/leads/string"{ "name": "string", "fullAddress": "string", "categories": [ "string" ], "phone": "string", "website": "http://example.com", "rating": 0, "reviewCount": 0, "emails": [ {} ], "socials": { "property1": "http://example.com", "property2": "http://example.com" }}List every lead in this account GET
Every lead you own, regardless of how it got here — searches and dataset unlocks alike. Scoping leads to a search only ever worked because search was the single way in; an unlocked row has no job and would be invisible. Keyset-paginated newest first; pass `cursor` from the previous response. Requires the `leads:read` scope when called with a scoped key.
Export all your leads GET
Downloads everything this account owns as one file — searches and dataset unlocks alike. Unlocked rows have no search behind them, so this is the only way to get them out in bulk. Free: you paid for these rows once already. Requires the `leads:export` scope when called with a scoped key.