Contact

Find contact phone

Asynchronously finds phone numbers from a Social profile URL, a Reverse Contact person id (prs_...), or a person name with company domain. The request is acknowledged with data.webhookId and data.pollUrl. Poll GET /v2/webhooks/{webhookId} for the phone array in data.result, or receive it on the optional webhookUrl callback. Credits: 20 when a phone number is found, 0 when no phone number is found. Enabled by default; the endpoint returns 410 for a workspace without phone finding access.

post/v2/contact/phone

Request

  • Base URL
    https://api.reversecontact.com
  • Auth
    HTTP bearer

Headers

Idempotency-Keystring

Optional. A key you choose (1 to 255 printable ASCII characters, a UUID for example) that makes the request safe to retry. For 24 hours, a request with the same key and the same body returns the first response with Idempotent-Replayed: true, without starting another lookup or debiting credits.

Request body

OR
OR
OR

Example request

{
  "url": "https://social.com/in/janedoe",
  "id": "prs_01jbd5vewyenebxgaz869ffe5t",
  "fullName": "Jane Doe",
  "firstName": "Jane",
  "lastName": "Doe",
  "companyDomain": "acme.com"
}

Response

Contact phone lookup task created

successtrue required
errorunknown required

Example response

{
  "data": {
    "status": "created"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.