---
title: "Performs a number lookup."
method: POST
path: "/v1/lookups"
tags: ["NumberLookup"]
---

# Performs a number lookup.

`POST /v1/lookups`

## Request body

- NumberLookupRequest
  - `number` string, required — MSISDN in E.164 format to query.
  - `features` ApiFeature[] — Contains requested features. Fallback to LineType if not provided.
  - `rndFeatureOptions` RndFeatureOptions
    - `contactDate` string, date — Last contact date in YYYY-MM-DD format.

## Response `200`

Successful response

- NumberLookupResponse
  - `line` LineResponse
    - `carrier` string, nullable — Name of the carrier.
    - `type` 'Landline' | 'Mobile' | 'VoIP' | 'Special' | 'Freephone' | 'Other' — Represents the type of a phone line.
    - `mobileCountryCode` string, nullable — A numeric code (MCC) that uniquely identifies a country within the international telecommunications network.
    - `mobileNetworkCode` string, nullable — A distinct identifier assigned to a mobile network operator within a specific country, used in combination with MCC.
    - `ported` boolean, nullable — Indicates if a phone number has been transferred from its original network to a different provider.
    - `portingDate` string, nullable — Specifies the date, in ISO 8601 format, when a phone number was transferred from its original network to a new provider.
    - `error` ErrorResponse
      - `status` integer — The error status code.
      - `title` string — A short, human-readable summary of the error type.
      - `detail` string — A human-readable explanation specific to this occurrence of the error.
      - `type` string, nullable — A URI reference that identifies the error type.
  - `simSwap` SimSwapResponse
    - `swapped` boolean, nullable — Indicates whether SIM was changed.
    - `swapPeriod` 'Undefined' | 'SP4H' | 'SP12H' | 'SP24H' | 'SP48H' | 'SP5D' | 'SP7D' | 'SP14D' | 'SP30D' | 'SPMAX'
    - `error` ErrorResponse
      - `status` integer — The error status code.
      - `title` string — A short, human-readable summary of the error type.
      - `detail` string — A human-readable explanation specific to this occurrence of the error.
      - `type` string, nullable — A URI reference that identifies the error type.
  - `voIPDetection` VoIPDetectionResponse
    - `probability` 'Unknown' | 'Low' | 'Likely' | 'High'
    - `error` ErrorResponse
      - `status` integer — The error status code.
      - `title` string — A short, human-readable summary of the error type.
      - `detail` string — A human-readable explanation specific to this occurrence of the error.
      - `type` string, nullable — A URI reference that identifies the error type.
  - `rnd` RndResponse
    - `disconnected` boolean, nullable — Provides information whether the number was disconnected after provided last contact date.
    - `error` ErrorResponse
      - `status` integer — The error status code.
      - `title` string — A short, human-readable summary of the error type.
      - `detail` string — A human-readable explanation specific to this occurrence of the error.
      - `type` string, nullable — A URI reference that identifies the error type.
  - `countryCode` string — ISO 3166-1 alpha-2 two-letter country identifier
  - `traceId` string — The identifier for a trace.
  - `number` string — Requested MSISDN in E.164 format.

## Other responses

- `400` — Bad Request
- `401` — Invalid Authorization
- `402` — Account Locked
- `403` — API disabled
- `404` — Not Found
- `429` — Too Many Requests
- `500` — Internal Error

---

[API](https://skmtc.net/sinch/apis/number-lookup-api-v1.md) · [All operations](https://skmtc.net/sinch/apis/number-lookup-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sinch/number-lookup-api-v1/revisions/2117f1876b2a/schema)