Endpoints

Four contact lookups, each a POST to https://api.syncgtm.com/v1/api/enrich/<name> with a JSON body. They run the same waterfalls as the matching MCP tools and cost the same.

Endpoint	Cost	Required input	MCP equivalent
`POST /enrich/work-email`	1 credit per email found	`linkedin_url`, or `first_name` + `last_name` + `domain`	`find_work_email`
`POST /enrich/personal-email`	3 credits per email found	`linkedin_url`	`find_personal_email`
`POST /enrich/mobile`	10 credits per number found	`linkedin_url`	`find_mobile_number`
`POST /enrich/verify-email`	0.2 credits per verdict	`email`	`verify_email`

Request


POST /v1/api/enrich/work-email HTTP/1.1
Host: api.syncgtm.com
Authorization: Bearer sgtm_live_...
Content-Type: application/json
Idempotency-Key: 7d3c9f2e-1b4a-4e0c-9a51-2f6b8d0e4c11
 
{ "linkedin_url": "https://www.linkedin.com/in/janedoe" }

Header	Required	Notes
`Authorization`	Yes	`Bearer <api key>`. See Authentication.
`Content-Type`	Yes	`application/json`
`Idempotency-Key`	No	1–255 characters. Makes retries safe. See idempotency.

String fields are trimmed before validation. Each request is one lookup — there is no batch endpoint; loop over your list and stay inside the rate limit.

Response

Every successful lookup returns 200 with the same two fields:

Field	Type	Meaning
`status`	string	`found` or `not_found` for the find endpoints; `Verified` or `Unverified` for `verify-email`
`data`	object or `null`	The result when there is one; `null` on `not_found`


{ "status": "found", "data": { "email": "jane@stripe.com" } }


{ "status": "not_found", "data": null }

not_found is free. It means no provider in the waterfall had the data — not that the data does not exist.

Errors use a different shape, { "error": { "code", "message" } }, and a non-2xx status. See Errors.

Credits

Find endpoints charge only when they return found. A miss is free.
verify-email charges for a verdict — deliverable or not. An inconclusive check is free.
A request that fails, times out or is rejected is never charged.
Credits come from your organization’s balance, shared with the app and the MCP server. See usage and billing.