---
title: "Get inbound messages"
method: GET
path: "/messages-api/1/inbound"
tags: ["platform", "messages-api", "inbound-messages"]
---

# Get inbound messages

`GET /messages-api/1/inbound`

## 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/messages-api/1/inbound`
- 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

If you are unable to receive incoming messages to the endpoint of your choice in real-time, you can use this API call to fetch messages. Each request will return a batch of received messages, only once. The API request will only return new messages that arrived since the last API request.

## Query parameters

- `channel` 'APPLE_MB' | 'MESSENGER' | 'MMS' | 'SMS' | 'VIBER_BM' | 'WHATSAPP', required
- `limit` integer
- `applicationId` string
- `entityId` string
- `campaignReferenceId` string

## Response `200`

OK

- 899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708fMessagesApiIncomingMessageResponse
  - `results` 899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708fMessagesApiInboundEvent[], required: Incoming messages
    - `event` 'MO' | 'TYPING_STARTED' | 'TYPING_STOPPED', required: Event type.
  - `messageCount` integer: The number of messages returned in the `results` array.
  - `pendingMessageCount` integer: The number of messages that have not been pulled in.

## Other responses

- `400`: Bad Request
- `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)