Phone to Person

Reverse lookup a person profile from a phone number

POST /v1/prospect/phone-to-person

Phone to Person

cURL

curl --request POST \
  --url https://api.gtmapis.com/v1/prospect/phone-to-person \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "phone": "<string>"
}
'

200

{
  "person": {
    "linkedin_url": "<string>",
    "first_name": "<string>",
    "last_name": "<string>",
    "full_name": "<string>",
    "title": "<string>",
    "headline": "<string>",
    "location": "<string>",
    "company_name": "<string>",
    "email": "<string>",
    "phone": "<string>"
  },
  "found": true,
  "credits_charged": 123
}

Phone to Person

Reverse lookup a person profile from a phone number. Returns the person’s LinkedIn profile, name, title, company, and contact information.

Endpoint

POST /v1/prospect/phone-to-person

Request

phone · string · required

Phone number to look up (e.g., “[phone]”)

Example Request

cURL

curl -X POST https://api.gtmapis.com/v1/prospect/phone-to-person \
  -H "Content-Type: application/json" \
  -H "X-API-Key: gtm_test_your_key_here" \
  -d '{
    "phone": "[phone]"
  }'

Response

person · object

Person profile data

Show Person fields

linkedin_url · string

LinkedIn profile URL

first_name · string

First name

last_name · string

Last name

full_name · string

Full name

title · string

Current job title

headline · string

LinkedIn headline

location · string

Location

company_name · string

Company name

email · string

Email address (when available)

phone · string

Phone number

found · boolean

Whether a person was found

credits_charged · integer

Number of credits charged

Success Response

{
  "person": {
    "linkedin_url": "https://linkedin.com/in/janesmith",
    "first_name": "Jane",
    "last_name": "Smith",
    "full_name": "Jane Smith",
    "title": "VP of Sales",
    "headline": "Driving revenue growth at Acme",
    "location": "San Francisco, CA",
    "company_name": "Acme Inc",
    "email": "[e-mail]",
    "phone": "[phone]"
  },
  "found": true,
  "credits_charged": 5
}

Not Found Response

{
  "person": null,
  "found": false,
  "credits_charged": 0
}

Credit Pricing

Result	Credits Charged
Person found	5 credits
Not found	0 credits
Error / failure	0 credits

Phone-to-person lookups cost 5 credits per successful result. No charge if the lookup returns no results.

Error Responses

400 Bad Request

{
  "error": "Bad Request",
  "message": "phone is required"
}

401 Unauthorized

{
  "error": "Unauthorized",
  "message": "Invalid API key"
}

Use Cases

Missed call identification

Identify unknown callers by reversing their phone number to a full person profile with company and title.

Phone list enrichment

Enrich raw phone lists with full prospect profiles to qualify and prioritize follow-ups.

Lead routing

Automatically route inbound calls by looking up the caller’s company and seniority in real time.

Related Endpoints

Email to Person

Reverse lookup person from email

Phone from LinkedIn

Get phone from LinkedIn profile

Email from LinkedIn

Get email from LinkedIn profile

ICP Search

Find people matching your ICP

Company Search

Find companies matching criteria

Prospect Account

Check account status and credits