---
title: "Carrier Lookup"
method: GET
path: "/api/v2/lookups/{phone}"
tags: ["Lookup"]
---

# Carrier Lookup

`GET /api/v2/lookups/{phone}`

<a class="try-sandbox-link" href="https://sandbox.textmagic.com/#/Lookup/doCarrierLookup" target="_blank">Try in sandbox</a><br>This API call allows you to retrieve additional information about a phone number: region-specific phone number formatting, carrier, phone type (landline/mobile) and country information.

> Numbers must be checked one by one. You cannot check multiple numbers in one request.

## Path parameters

- `phone` string, required

## Query parameters

- `country` string

## Response `200`

Returned when successful.

- DoCarrierLookupResponse
  - `cost` number, required — The cost to check that one number is constant – 0.04 in your account currency.
  - `country` Country, nullable
    - `id` string, required — The 2-letter ISO country ID.
    - `name` string, required — Full country name.
  - `local` string, required — Phone number in [National format](https://en.wikipedia.org/wiki/National_conventions_for_writing_telephone_numbers).
  - `type` 'mobile' | 'landline' | 'voip', required — Phone number type.
  - `carrier` string, required — Carrier name.
  - `number164` string, required — Phone number in [E.164 format](https://en.wikipedia.org/wiki/E.164).
  - `valid` boolean, required — This field shows whether the entered phone number is valid or not.

## Other responses

- `400` — Bad request.
- `401` — Unauthorized request.
- `429` — Returned when the number of queries per second is too high.

---

[API](https://skmtc.net/textmagic/apis/textmagic-api.md) · [All operations](https://skmtc.net/textmagic/apis/textmagic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/textmagic/textmagic-api/revisions/3e4029d19684/schema)