Start bulk phone find

curl --request POST \
  --url https://api.generect.com/api/v1/phone/find/bulk/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "leads": [
    {
      "lead_id": "lead_abc123xyz"
    },
    {
      "first_name": "John",
      "last_name": "Doe",
      "company": "acme.com"
    }
  ]
}
'

{
  "data": null,
  "meta": {
    "job_id": "job_123",
    "status": "pending",
    "total": 2,
    "processed": 0,
    "amount_charged": 0,
    "error": null
  }
}

POST

phone

find

bulk

Start bulk phone find

curl --request POST \
  --url https://api.generect.com/api/v1/phone/find/bulk/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "leads": [
    {
      "lead_id": "lead_abc123xyz"
    },
    {
      "first_name": "John",
      "last_name": "Doe",
      "company": "acme.com"
    }
  ]
}
'

{
  "data": null,
  "meta": {
    "job_id": "job_123",
    "status": "pending",
    "total": 2,
    "processed": 0,
    "amount_charged": 0,
    "error": null
  }
}

Use Case:

Start an asynchronous bulk phone finder job.

Pricing

This is a billable endpoint — you are charged only for each phone number found. If no phone is found, the request is free.

Your price decreases automatically as your lifetime spend grows. Check your current tier and pricing →

Authorizations

Authorization

string

header

required

Use the required Token prefix. Example: Authorization: Token xxxxxxxxx

Body

application/json

leads

(By Lead ID · object | By LinkedIn URL · object | By Name and Company · object)[]

required

List of leads to find phones for. Each entry is either a lead_id, linkedin_url, or name+company.

By Lead ID
By LinkedIn URL
By Name and Company

Show child attributes

Response

Bulk phone job accepted

data

object

Always null — results arrive via the bulk status endpoint.

​Use Case:

​Pricing

Authorizations

Body

Response

Use Case:

Pricing