---
title: "Number Context lookup (async)"
method: POST
path: "/number/1/notify"
tags: ["connectivity", "number-lookup"]
---

# Number Context lookup (async)

`POST /number/1/notify`

## 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/notify`
- 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 requested phone numbers and receive information at some endpoint asynchronously. Information may vary per country and your package. For package change, contact your account manager or [support](https://www.infobip.com/contact).

## Request body

- 20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630NcNotifyRequest
  - `notifyContentType` string: Preferred lookup report content type. Can be `application/json` or `application/xml`.
  - `notifyUrl` string: The URL on your call back server on which the lookup report will be sent.
  - `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

- 20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630NcResponseAsync
  - `results` 20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630NcResponseAsyncDetails[]: Collection of preliminary lookup results.
    - `to` string: The looked up phone number.
    - `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.
    - `messageId` string: The ID that uniquely identifies the performed lookup.
  - `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)