---
title: "Get Number Context logs"
method: GET
path: "/number/1/logs"
tags: ["connectivity", "number-lookup"]
---

# Get Number Context logs

`GET /number/1/logs`

## 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/logs`
- 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 logs of sent Number Context requests.

## Query parameters

- `to` string
- `bulkId` string[]
- `messageId` string[]
- `generalStatus` 'ACCEPTED' | 'PENDING' | 'UNDELIVERABLE' | 'DELIVERED' | 'EXPIRED' | 'REJECTED': Status group name that describes which category the status code belongs to, i.e., [PENDING](https://www.infobip.com/docs/essentials/response-status-and-error-codes#pending-general-status-codes), [UNDELIVERABLE](https://www.infobip.com/docs/essentials/response-status-and-error-codes#undeliverable-general-status-codes), [DELIVERED](https://www.infobip.com/docs/essentials/response-status-and-error-codes#delivered-general-status-codes), [EXPIRED](https://www.infobip.com/docs/essentials/response-status-and-error-codes#expired-general-status-codes), [REJECTED](https://www.infobip.com/docs/essentials/response-status-and-error-codes#rejected-general-status-codes).
- `sentSince` string, date-time
- `sentUntil` string, date-time
- `limit` integer
- `mcc` string
- `mnc` string

## Response `200`

Successful response

- 4033c81feb806caaa02f9cef553f79f0137a7aaa85d200d9d5e6449874c43c3dNcLogResponse
  - `results` 4033c81feb806caaa02f9cef553f79f0137a7aaa85d200d9d5e6449874c43c3dNcLog[]: Collection of logs.
    - `bulkId` string: The ID that uniquely identifies the request.
    - `messageId` string: The ID that uniquely identifies the performed lookup.
    - `to` string: The looked up phone number.
    - `sentAt` string, date-time: Tells when the lookup was performed. Has the following format: `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.
    - `doneAt` string, date-time: Tells when Infobip finished processing the lookup (e.g. lookup request was delivered to the destination network). Has the following format: `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.
    - `mccMnc` string: Mobile country and network codes.
    - `price` 20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630NcLogPrice
      - `currency` string: The currency in which the price is expressed.
      - `pricePerLookup` number, double: Price per one NC lookup.
    - `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.

## Other responses

- `400`: Error responses
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests
- `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)
