---
title: "Number Context lookup"
method: POST
path: "/number/1/query"
tags: ["connectivity", "number-lookup"]
---

# Number Context lookup

`POST /number/1/query`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/number/1/query`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic

This method allows you to get Number Context information for the requested phone numbers. For package change, contact your account manager or [support](https://www.infobip.com/contact).

## Request body

- 20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630NcQueryRequest
  - `to` string[], required: Array of phone numbers to look up. Numbers must be in international format (Example: `41793026727`). Numbers longer than 256 characters in the request will be clipped during processing. The clipped numbers will be included in the response, reports, and logs.

## Response `200`

Successful response

- 20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630NcResponse
  - `results` 20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630NcResponseDetails[]: Collection of lookup results.
    - `to` string: The looked up phone number.
    - `mccMnc` string: Mobile country code and mobile network code concatenated. MccMnc will start with the MCC, and it will always have three digits, followed by the MNC (length of the MNC depends on the value of the MCC, and it can be two or three).
    - `imsi` string: International Mobile Subscriber Identity, used to uniquely identify the user of a mobile network.
    - `originalNetwork` 20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630Network: Information about the roaming network.
      - `networkName` string: Optional human readable name of the network.
      - `networkPrefix` string: Network prefix.
      - `countryName` string: Optional name of the country the network operates in.
      - `countryPrefix` string: Country prefix.
      - `networkId` integer: ID of the network.
    - `ported` boolean: True if number has been ported.
    - `portedNetwork` 20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630Network: Information about the roaming network.
      - `networkName` string: Optional human readable name of the network.
      - `networkPrefix` string: Network prefix.
      - `countryName` string: Optional name of the country the network operates in.
      - `countryPrefix` string: Country prefix.
      - `networkId` integer: ID of the network.
    - `roaming` boolean: True if number is currently in roaming.
    - `roamingNetwork` 20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630Network: Information about the roaming network.
      - `networkName` string: Optional human readable name of the network.
      - `networkPrefix` string: Network prefix.
      - `countryName` string: Optional name of the country the network operates in.
      - `countryPrefix` string: Country prefix.
      - `networkId` integer: ID of the network.
    - `servingMSC` string: Serving mobile switching center.
    - `status` 20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630NcStatus
      - `groupId` integer: Status group ID.
      - `groupName` string: Status group name that describes which category the status code belongs to, e.g. PENDING, UNDELIVERABLE, DELIVERED, EXPIRED, REJECTED.
      - `id` integer: Status ID.
      - `name` string: [Status name](https://www.infobip.com/docs/essentials/response-status-and-error-codes).
      - `description` string: Human-readable description of the status.
      - `action` string: Action that should be taken to recover from the error.
    - `error` 20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630NcError
      - `groupId` integer: Error group ID.
      - `groupName` string: Error group name.
      - `id` integer: Error ID.
      - `name` string: Error name.
      - `description` string: Human-readable description of the error.
      - `permanent` boolean: Tells if the error is permanent.
  - `bulkId` string: The ID that uniquely identifies the request.

## Other responses

- `400`: Error responses
- `401`: Unauthorized
- `403`: Forbidden
- `500`: Internal Server Error

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)