# Messages

## M10 - Retrieve a thread

 - [GET /api/inbox/threads/{thread_id}](https://developer.mirakl.com/content/product/mmp/rest/front/openapi3/messages/m10.md): Call Frequency

Recommended usage: Synchronous only - At each page that includes a message thread display
Maximum usage: Synchronous only - At each page that includes a message thread display
Read More

More context (Products Marketplace)More context (Services Marketplace)

## M11 - List all threads

 - [GET /api/inbox/threads](https://developer.mirakl.com/content/product/mmp/rest/front/openapi3/messages/m11.md): Description

You may want to retrieve the threads linked to a specific entity, using both entity_type and entity_id.
For example, to retrieve threads for an order, use entity_type=MMP_ORDER&entity_id=my-order-1.

Available values for entity_type are:

MMP_ORDER: for threads on product orders
MMP_OFFER: for threads on offers
MPS_ORDER: for threads on service orders
MPS_SERVICE: for threads on services
SELLER_OPERATOR: for threads between sellers and operator


This resource uses seek pagination. The default value for parameter limit is 50.



Call Frequency

Recommended usage: Synchronous only - At each page that includes an inbox display
Maximum usage: Synchronous only - At each page that includes an inbox display
Read More

More context (Products Marketplace)More context (Services Marketplace)Pagination

This resource supports seek pagination (see documentation)

## M12 - Reply to a thread

 - [POST /api/inbox/threads/{thread_id}/message](https://developer.mirakl.com/content/product/mmp/rest/front/openapi3/messages/m12.md): Description

Maximum of 1000 messages on a thread


Call Frequency

Recommended usage: Synchronous only - At each thread answer
Maximum usage: Synchronous only - At each thread answer
Read More

More context (Products Marketplace)More context (Services Marketplace)

## M13 - Download an attachment

 - [GET /api/inbox/threads/{attachment_id}/download](https://developer.mirakl.com/content/product/mmp/rest/front/openapi3/messages/m13.md): Call Frequency

Recommended usage: Synchronous only - At each message attachment download
Maximum usage: Synchronous only - At each message attachment download
Read More

More context (Products Marketplace)More context (Services Marketplace)

## OR43 - Create a thread on an order

 - [POST /api/orders/{order_id}/threads](https://developer.mirakl.com/content/product/mmp/rest/front/openapi3/messages/or43.md): Description

Each message has a 30 Megabyte size limit, regardless of the number of attachments in the message.


Call Frequency

Recommended usage: At each new thread posted on an order
Maximum usage: At each new thread posted on an order

## M01 - List messages linked to orders and offers (deprecated)

 - [GET /api/messages](https://developer.mirakl.com/content/product/mmp/rest/front/openapi3/messages/m01.md): Deprecated endpoint

This API is going to be removed in a future update, please use M10 and M11 instead


Call Frequency

Recommended usage: Synchronous only - at each message list display
Maximum usage: Synchronous only - at each message list display
Pagination

This resource supports offset pagination (see documentation)

Sort fields

sort field can have the following values:dateCreated (Default) - Sort by creation date (desc by default)

## OR42 - Post a message on an order (deprecated)

 - [POST /api/orders/{order_id}/messages](https://developer.mirakl.com/content/product/mmp/rest/front/openapi3/messages/or42.md): Deprecated endpoint

This API will be removed in a future version. Use OR43 and M12 instead.

Description

Customer will be created if it does not exist. Otherwise, every field will be updated (optional fields will be updated only if present). Maximum of 1000 messages on a thread


Call Frequency

Recommended usage: At each new message posted on an order
Maximum usage: At each new message posted on an order
Read More

More context (message integration)More context (message attachment)More context (sellers)