# Retrieving incoming messages

This article details commonly used API operations. Each section corresponds to an operation and includes a brief overview, a sample request and response payload, and schema information pulled directly from the API reference. Additionally, each section will include links to the corresponding [API reference entry](../api-reference/) and any tutorials (if available).

Note:
For information on how complete the configuration steps required for this API, along with language-specific guides that illustrate the API's functionality with pre-populated examples, see the [Getting started](../getting-started/) guides that correspond to this API.

Mobile Originated (MO) messages, or inbounds, are incoming messages. Inbound messages can be listed and retrieved like batch messages and they can also be delivered by callback requests like delivery reports.

## List incoming messages

This operation enables you to list all inbound messages that you have received. Results are returned in reverse chronological order meaning users will see the most recently received messages near the top of the list. This operation is highly customizable. Users can filter results by date range and `to` number. If there is a high volume of batches, results can be paginated. Pagination is flexible, with the `page` and `page_size` query parameters enabling users to set the number of pages and the number of results per page.

### List incoming messages request and response

Below are code samples that highlight how to make this API request in multiple languages. A sample response is also provided. Select your preferred coding language from the language drop-down list:

For the full schema of the response that corresponds to this API call, see the [corresponding entry](/docs/sms/api-reference/sms/inbounds/listinboundmessages) in the API reference.

For the full schema of the response that corresponds to this API call, see the [corresponding entry](/docs/sms/api-reference/sms/inbounds/listinboundmessages) in the API reference.

## Retrieve inbound message

This operation retrieves a specific inbound message with the provided inbound ID.

### Retrieve inbound message request and response

Below are code samples that highlight how to make this API request in multiple languages. A sample response is also provided. Select your preferred coding language from the language drop-down list:

For the full schema of the request that corresponds to this API call, see the [corresponding entry](/docs/sms/api-reference/sms/inbounds/retrieveinboundmessage) in the API reference.

For all possible response schemas that correspond to this API call, see the [corresponding entry](/docs/sms/api-reference/sms/inbounds/retrieveinboundmessage) in the API reference.