---
title: "Phone Number Validation"
method: GET
path: "/phone_numbers"
tags: ["Phone Numbers"]
---

# Phone Number Validation

`GET /phone_numbers`

## Request

- Base URL: `https://api.addresszen.com/v1`
- URL: `https://api.addresszen.com/v1/phone_numbers`
- Auth: HTTP bearer

Validates a phone number and returns its country, its national and international formats, and the network it was originally assigned to.

Requires an API Key licensed for phone validation.

Every query decrements your lookup balance, including a number that fails to parse and a number reported as invalid.

## Query parameters

- `api_key` string
- `query` string, required
- `current_carrier` 'true'
- `tags` string

## Response `200`

Success

- PhoneNumberResponse
  - `code` 2000, required
  - `message` 'Success', required
  - `result` union, required
    - PhoneNumber
      - `valid` true, required
      - `national_format` string, required: Phone number formatted to local standard
      - `international_format` string, required: Phone number formatted to international standard
      - `iso_country` string, required: Country code in 3 letter ISO format
      - `iso_country_2` string, required: Country code in 2 letter ISO format
      - `country` string, required: Full country name
      - `current_carrier` Carrier, nullable, required
        - `network_code` string, nullable, required: The [Mobile Country Code](https://en.wikipedia.org/wiki/Mobile_country_code) for the carrier.
        - `name` string, nullable, required: The full name of the carrier that number is associated with.
        - `country` string, nullable, required: Country that number is associated with. In ISO 3166-1 alpha-2 format.
        - `network_type` 'mobile' | 'landline' | 'landline_premium' | 'landline_tollfree' | 'virtual' | 'unknown' | 'pager' | 'mobile_or_landline' | 'shared_cost' | 'uan' | 'voicemail', nullable, required: Type of network that number is associated with.
      - `original_carrier` Carrier, nullable, required
        - `network_code` string, nullable, required: The [Mobile Country Code](https://en.wikipedia.org/wiki/Mobile_country_code) for the carrier.
        - `name` string, nullable, required: The full name of the carrier that number is associated with.
        - `country` string, nullable, required: Country that number is associated with. In ISO 3166-1 alpha-2 format.
        - `network_type` 'mobile' | 'landline' | 'landline_premium' | 'landline_tollfree' | 'virtual' | 'unknown' | 'pager' | 'mobile_or_landline' | 'shared_cost' | 'uan' | 'voicemail', nullable, required: Type of network that number is associated with.
    - InvalidPhoneNumber
      - `valid` false, required
      - `national_format` 'null', nullable, required: Phone number formatted to local standard
      - `international_format` 'null', nullable, required: Phone number formatted to international standard
      - `iso_country` 'null', nullable, required: Country code in 3 letter ISO format
      - `iso_country_2` 'null', nullable, required: Country code in 2 letter ISO format
      - `country` 'null', nullable, required: Full country name
      - `current_carrier` 'null', nullable: Representation of current phone carrier information like network code, name, country, network type
      - `original_carrier` 'null', nullable: Representation of original phone carrier information like network code, name, country, network type

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/addresszen/apis/api-reference.md) · [All operations](https://skmtc.dev/addresszen/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc.dev/addresszen/apis/api-reference/revisions/cac119db15c0?raw)