# OR41 - List messages of an order (deprecated)

By default, all sent, received and unarchived message are listedCall FrequencyRecommended usage: On each message page viewMaximum usage: On each message page viewPaginationThis resource supports offset pagination (see documentation)Sort fieldssort field can have the following values:dateCreated (Default) - Sort by creation date (desc by default)

Endpoint: GET /api/orders/{order_id}/messages

## Path parameters:

  - `order_id` (string, required)
    Order identifier

## Query parameters:

  - `received` (string)
    If "TRUE" ("FALSE") returns only messages received by (sent to) shop.
    Enum: "TRUE", "FALSE", "ALL"

  - `shop_id` (integer)
    Use this parameter when your user has access to several shops. If not specified, the shop_id from your default shop will be used.

  - `read` (string)
    Ignored, will be removed in a future version
    Enum: "TRUE", "FALSE", "ALL"

  - `archived` (string)
    Ignored, will be removed in a future version
    Enum: "TRUE", "FALSE", "ALL"

## Response 200 fields (application/json):

  - `messages` (array, required)
    List of messages

  - `messages.body` (string, required)
    Message body

  - `messages.commercial_id` (string, required)
    Order commercial ID. Used only when retrieving messages of an order.

  - `messages.date_created` (string, required)
    Message creation date

  - `messages.documents` (array)
    Documents list

  - `messages.documents.date_uploaded` (string)
    Document uploaded date

  - `messages.documents.file_name` (string, required)
    Document file name

  - `messages.documents.file_size` (integer)
    File size

  - `messages.documents.id` (integer, required)
    Document identifier

  - `messages.documents.type` (string, required)
    Document type code

  - `messages.from_id` (string, required)
    Sender user identifier

  - `messages.from_name` (string, required)
    Sender user name

  - `messages.from_type` (string, required)
    Sender user type
    Enum: "OPERATOR", "SHOP", "CUSTOMER"

  - `messages.id` (integer, required)
    Message identifier

  - `messages.offer_id` (integer)
    Identifier of offer : this value is not fixed and can changed after a long period

  - `messages.order_id` (string)
    Order ID. Used only when retrieving messages of an order.

  - `messages.subject` (string, required)
    Message subject

  - `messages.to_customer_id` (string, required)
    Recipient customer ID

  - `messages.to_customer_name` (string, required)
    Recipient customer name

  - `messages.to_operator` (boolean, required)
    Indicates the message sent to operator. Used only when retrieving messages of an order.

  - `messages.to_shop_id` (integer, required)
    Recipient shop ID

  - `messages.to_shop_name` (string, required)
    Recipient shop name

  - `messages.archived` (boolean)
    Will be removed in next version

  - `messages.read` (boolean)
    Will be removed in next version

  - `messages.to_customer_archived` (boolean, required)
    Will be removed in next version

  - `messages.to_operator_archived` (boolean, required)
    Will be removed in next version

  - `messages.to_shop_archived` (boolean, required)
    Will be removed in next version

  - `messages.visible` (boolean)
    States whether or not the message is visible (public). Only relevant for messages on offers and always null for messages on orders.

  - `total_count` (integer, required)
    Total count of messages