---
title: "[USES 11 UNITS PER NAME] Infer the likely country and phone prefix, given a personal name and formatted / unformatted phone number."
method: GET
path: "/api2/json/phoneCode/{firstName}/{lastName}/{phoneNumber}"
tags: ["social"]
---

# \[USES 11 UNITS PER NAME\] Infer the likely country and phone prefix, given a personal name and formatted / unformatted phone number.

`GET /api2/json/phoneCode/{firstName}/{lastName}/{phoneNumber}`

## Path parameters

- `firstName` string, required
- `lastName` string, required
- `phoneNumber` string, required

## Response `200`

A name with country and phone code.

- FirstLastNamePhoneCodedOut — Represents the output of inferring the LIKELY country and phone code from a personal name and phone number.
  - `script` string
  - `id` string
  - `explanation` string
  - `firstName` string — The first name (also known as given name)
  - `lastName` string — The last name (also known as family name, or surname)
  - `internationalPhoneNumberVerified` string — The normalized phone number, verified using libphonenumber.
  - `phoneCountryIso2Verified` string — The phone ISO2 country code, verified using libphonenumber.
  - `phoneCountryCode` integer — The phone country code of the phone number, verified using libphonenumber.
  - `phoneCountryCodeAlt` integer — The best alternative phone country code of the phone number.
  - `phoneCountryIso2` string — The likely country of the phone number.
  - `phoneCountryIso2Alt` string — The best alternative country of the phone number.
  - `originCountryIso2` string — The likely country of origin of the name.
  - `originCountryIso2Alt` string — The best alternative country of origin of the name.
  - `phoneNumber` string — The input phone number.
  - `verified` boolean — Indicates if the phone number could be positively verified using libphonenumber.
  - `score` number, double — Higher score is better, but score is not normalized. Use calibratedProbability if available.
  - `countryIso2` string

## Other responses

- `401` — Missing or incorrect API Key
- `403` — Email not Verified, or API Limit Reached, or API Key Disabled
- `429` — Too Many Requests

---

[API](https://skmtc.dev/namsor/apis/namsor-api-v2.md) · [All operations](https://skmtc.dev/namsor/apis/namsor-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/namsor/namsor-api-v2/revisions/305e4f6eeaf5/schema)