Contacts lookup

Look up one phone number

Query param phone or cellphone. Returns the full releases row in data when found; success: false with no charge when not found.

GET/api/v1/contacts/lookup/phone

Authorization

Header	Type	Required	Description
`X-API-Key`	string	required	Your API key, for example `lb_live_YOUR_API_KEY`. You can send the same key as `Authorization: Bearer` instead.

Query parameters

Name	Type	Required	Default	Description
`phone`	string	required		Pass this as a query string value.
`cellphone`	string	required		Pass this as a query string value.

Response

ok boolean: True when the request succeeded.
success boolean: True when this request found a match.
data object: The matched record, or null when nothing matched.
creditsRemaining number: Plan credits left after this request. Null on unlimited plans.

curl -sS "https://leadmcp.ai/api/v1/contacts/lookup/phone?phone=%2B1+415-555-0142" \
  -H "X-API-Key: lb_live_YOUR_API_KEY"

Response200

{
  "ok": true,
  "success": true,
  "data": {
    "first_name": "Jane",
    "last_name": "Doe",
    "email_address": "jane@acme.com",
    "cellphone": "+1 415-555-0142",
    "domain_org": "acme.com"
  },
  "creditsRemaining": 4999
}