# List messages

This operation lists all messages sent or received via particular Processing Modes.

Setting the messages_source parameter to CONVERSATION_SOURCE allows for querying messages in CONVERSATION mode, and setting it to DISPATCH_SOURCE
will allow for queries of messages in DISPATCH mode. Note that conversation_id and contact_id are only supported as query parameters if messages_source is set to CONVERSATION_SOURCE.

Combining multiple parameters is supported for more detailed filtering of messages, but some of them are not supported
depending on the value specified for messages_source. The description for each field will inform if that field may not be supported.

The messages are ordered by their accept_time property in descending order,
where accept_time is a timestamp of when the message was enqueued by the Conversation API.
This means messages received most recently will be listed first.

Endpoint: GET /v1/projects/{project_id}/messages
Version: 1.0
Security: Basic, oAuth2

## Path parameters:

  - `project_id` (string, required)
    The unique ID of the project. You can find this on the Sinch Dashboard.

## Query parameters:

  - `conversation_id` (string)
    Resource name (ID) of the conversation.

  - `contact_id` (string)
    Resource name (ID) of the contact.

  - `app_id` (string)
    Id of the app.

  - `channel_identity` (string)
    Channel identity of the contact.

  - `start_time` (string)
    Filter messages with accept_time after this timestamp. Must be before end_time if that is specified.

  - `end_time` (string)
    Filter messages with accept_time before this timestamp.

  - `page_size` (integer)
    Maximum number of messages to fetch. Defaults to 10
and the maximum is 1000.

  - `page_token` (string)
    Next page token previously returned if any. When specifying this token, make sure to use the same values
for the other parameters from the request that originated the token, otherwise the paged results may be inconsistent.

  - `view` (string)
    Enum: "WITH_METADATA", "WITHOUT_METADATA"

  - `messages_source` (string)
    Specifies the message source for which the request will be processed. Used for operations on messages in Dispatch Mode. For more information, see Processing Modes.
    Enum: "CONVERSATION_SOURCE", "DISPATCH_SOURCE"

  - `only_recipient_originated` (boolean)
    If true, fetch only recipient originated messages.

  - `channel` (string)
    Only fetch messages from the channel.
    Enum: "WHATSAPP", "RCS", "SMS", "MESSENGER", "VIBERBM", "MMS", "INSTAGRAM", "TELEGRAM", "KAKAOTALK", "KAKAOTALKCHAT", "LINE", "WECHAT", "APPLEBC"

  - `direction` (string)
    Optional. Only fetch messages with the specified direction. If direction is not specified, it will list both TO_APP and TO_CONTACT messages.
    Enum: "TO_APP", "TO_CONTACT"

## Response 200 fields (application/json):

  - `messages` (array) — one of:
    List of messages associated to the referenced conversation.
    - App Message:
      - `app_message` (object) — one of:
        A message originating from a Conversation API app
        - Card:
          - `card_message` (object)
            Message containing text, media and choices.
          - `card_message.choices` (array) — one of:
            You may include choices in your Card Message. The number of choices is limited to 10.
            - Call:
              - `call_message` (object)
              - `call_message.phone_number` (string, required)
                Phone number in E.164 with leading +.
                Example: "+15551231234"
              - `call_message.title` (string, required)
                Title shown close to the phone number.
The title is clickable in some cases.
                Example: "Message text"
            - Location:
              - `location_message` (object)
              - `location_message.coordinates` (object, required)
              - `location_message.coordinates.latitude` (number, required)
                The latitude.
              - `location_message.coordinates.longitude` (number, required)
                The longitude.
              - `location_message.title` (string, required)
                The title is shown close to the button or link that leads to a map showing the location. The title can be clickable in some cases.
              - `location_message.label` (string)
                Label or name for the position.
            - Text:
              - `text_message` (object)
              - `text_message.text` (string, required)
                The text to be sent.
            - URL:
              - `url_message` (object)
              - `url_message.title` (string, required)
                The title shown close to the URL. The title can be clickable in some cases.
              - `url_message.url` (string, required)
                The url to show.
            - Calendar:
              - `calendar_message` (object)
              - `calendar_message.title` (string, required)
                The title is shown close to the button that leads to open a user calendar.
              - `calendar_message.event_start` (string, required)
                The timestamp defines start of a calendar event.
                Example: "2025-11-30T10:00:00Z"
              - `calendar_message.event_end` (string, required)
                The timestamp defines end of a calendar event.
                Example: "2025-11-30T11:00:00Z"
              - `calendar_message.event_title` (string, required)
                Title of a calendar event.
              - `calendar_message.fallback_url` (string, required)
                The URL that is opened when the user cannot open a calendar event directly or channel does not have support for this type.
              - `calendar_message.event_description` (string)
                Description of a calendar event.
            - Request location:
              - `share_location_message` (object)
              - `share_location_message.title` (string, required)
                The title is shown close to the button that leads to open a map to share a location.
              - `share_location_message.fallback_url` (string, required)
                The URL that is opened when channel does not have support for this type.
          - `card_message.choices.postback_data` (any)
            An optional field. This data will be returned in the ChoiceResponseMessage. The default is message_id_{text, title}.
          - `card_message.description` (string)
            This is an optional description field that is displayed below the title on the card.
          - `card_message.height` (string)
            You can set the desired size of the card in the message.
            Enum: "UNSPECIFIED_HEIGHT", "SHORT", "MEDIUM", "TALL"
          - `card_message.title` (string)
            The title of the card message.
          - `card_message.media_message` (object)
            A message containing a media component.
          - `card_message.media_message.url` (string, required)
            Url to the media file.
          - `card_message.media_message.thumbnail_url` (string)
            An optional parameter. Will be used where it is natively supported.
          - `card_message.media_message.filename_override` (string)
            Overrides the media file name.
          - `card_message.message_properties` (object)
            Optional additional properties.
          - `card_message.message_properties.whatsapp_header` (string)
            Optional. Sets the header for the footer of a WhatsApp reply button message, if there is no media in the message. Ignored for other channels. Ignored if not transcoded to a native WhatsApp message with reply buttons.
        - Carousel:
          - `carousel_message` (object)
          - `carousel_message.cards` (array, required)
            A list of up to 10 cards.
          - `carousel_message.cards.choices` (array) — one of:
            You may include choices in your Card Message. The number of choices is limited to 10.
            - Call:
              - `call_message` (object)
              - `call_message.phone_number` (string, required)
                Phone number in E.164 with leading +.
                Example: "+15551231234"
              - `call_message.title` (string, required)
                Title shown close to the phone number.
The title is clickable in some cases.
                Example: "Message text"
            - Location:
              - `location_message` (object)
              - `location_message.coordinates` (object, required)
              - `location_message.coordinates.latitude` (number, required)
                The latitude.
              - `location_message.coordinates.longitude` (number, required)
                The longitude.
              - `location_message.title` (string, required)
                The title is shown close to the button or link that leads to a map showing the location. The title can be clickable in some cases.
              - `location_message.label` (string)
                Label or name for the position.
            - Text:
              - `text_message` (object)
              - `text_message.text` (string, required)
                The text to be sent.
            - URL:
              - `url_message` (object)
              - `url_message.title` (string, required)
                The title shown close to the URL. The title can be clickable in some cases.
              - `url_message.url` (string, required)
                The url to show.
            - Calendar:
              - `calendar_message` (object)
              - `calendar_message.title` (string, required)
                The title is shown close to the button that leads to open a user calendar.
              - `calendar_message.event_start` (string, required)
                The timestamp defines start of a calendar event.
                Example: "2025-11-30T10:00:00Z"
              - `calendar_message.event_end` (string, required)
                The timestamp defines end of a calendar event.
                Example: "2025-11-30T11:00:00Z"
              - `calendar_message.event_title` (string, required)
                Title of a calendar event.
              - `calendar_message.fallback_url` (string, required)
                The URL that is opened when the user cannot open a calendar event directly or channel does not have support for this type.
              - `calendar_message.event_description` (string)
                Description of a calendar event.
            - Request location:
              - `share_location_message` (object)
              - `share_location_message.title` (string, required)
                The title is shown close to the button that leads to open a map to share a location.
              - `share_location_message.fallback_url` (string, required)
                The URL that is opened when channel does not have support for this type.
          - `carousel_message.cards.choices.postback_data` (any)
            An optional field. This data will be returned in the ChoiceResponseMessage. The default is message_id_{text, title}.
          - `carousel_message.cards.description` (string)
            This is an optional description field that is displayed below the title on the card.
          - `carousel_message.cards.height` (string)
            You can set the desired size of the card in the message.
            Enum: same as `card_message.height` in "Card" (4 values)
          - `carousel_message.cards.title` (string)
            The title of the card message.
          - `carousel_message.cards.media_message` (object)
            A message containing a media component.
          - `carousel_message.cards.media_message.url` (string, required)
            Url to the media file.
          - `carousel_message.cards.media_message.thumbnail_url` (string)
            An optional parameter. Will be used where it is natively supported.
          - `carousel_message.cards.media_message.filename_override` (string)
            Overrides the media file name.
          - `carousel_message.cards.message_properties` (object)
            Optional additional properties.
          - `carousel_message.cards.message_properties.whatsapp_header` (string)
            Optional. Sets the header for the footer of a WhatsApp reply button message, if there is no media in the message. Ignored for other channels. Ignored if not transcoded to a native WhatsApp message with reply buttons.
          - `carousel_message.choices` (array) — one of:
            Optional. Outer choices on the carousel level. The number of outer choices is limited to 3.
            - Call:
              - `call_message` (object)
              - `call_message.phone_number` (string, required)
                Phone number in E.164 with leading +.
                Example: "+15551231234"
              - `call_message.title` (string, required)
                Title shown close to the phone number.
The title is clickable in some cases.
                Example: "Message text"
            - Location:
              - `location_message` (object)
              - `location_message.coordinates` (object, required)
              - `location_message.coordinates.latitude` (number, required)
                The latitude.
              - `location_message.coordinates.longitude` (number, required)
                The longitude.
              - `location_message.title` (string, required)
                The title is shown close to the button or link that leads to a map showing the location. The title can be clickable in some cases.
              - `location_message.label` (string)
                Label or name for the position.
            - Text:
              - `text_message` (object)
              - `text_message.text` (string, required)
                The text to be sent.
            - URL:
              - `url_message` (object)
              - `url_message.title` (string, required)
                The title shown close to the URL. The title can be clickable in some cases.
              - `url_message.url` (string, required)
                The url to show.
            - Calendar:
              - `calendar_message` (object)
              - `calendar_message.title` (string, required)
                The title is shown close to the button that leads to open a user calendar.
              - `calendar_message.event_start` (string, required)
                The timestamp defines start of a calendar event.
                Example: "2025-11-30T10:00:00Z"
              - `calendar_message.event_end` (string, required)
                The timestamp defines end of a calendar event.
                Example: "2025-11-30T11:00:00Z"
              - `calendar_message.event_title` (string, required)
                Title of a calendar event.
              - `calendar_message.fallback_url` (string, required)
                The URL that is opened when the user cannot open a calendar event directly or channel does not have support for this type.
              - `calendar_message.event_description` (string)
                Description of a calendar event.
            - Request location:
              - `share_location_message` (object)
              - `share_location_message.title` (string, required)
                The title is shown close to the button that leads to open a map to share a location.
              - `share_location_message.fallback_url` (string, required)
                The URL that is opened when channel does not have support for this type.
        - Choice:
          - `choice_message` (object)
            A message containing choices.
          - `choice_message.choices` (array, required) — one of:
            The number of choices is limited to 10.
            - Call:
              - `call_message` (object)
              - `call_message.phone_number` (string, required)
                Phone number in E.164 with leading +.
                Example: "+15551231234"
              - `call_message.title` (string, required)
                Title shown close to the phone number.
The title is clickable in some cases.
                Example: "Message text"
            - Location:
              - `location_message` (object)
              - `location_message.coordinates` (object, required)
              - `location_message.coordinates.latitude` (number, required)
                The latitude.
              - `location_message.coordinates.longitude` (number, required)
                The longitude.
              - `location_message.title` (string, required)
                The title is shown close to the button or link that leads to a map showing the location. The title can be clickable in some cases.
              - `location_message.label` (string)
                Label or name for the position.
            - Text:
              - `text_message` (object)
              - `text_message.text` (string, required)
                The text to be sent.
            - URL:
              - `url_message` (object)
              - `url_message.title` (string, required)
                The title shown close to the URL. The title can be clickable in some cases.
              - `url_message.url` (string, required)
                The url to show.
            - Calendar:
              - `calendar_message` (object)
              - `calendar_message.title` (string, required)
                The title is shown close to the button that leads to open a user calendar.
              - `calendar_message.event_start` (string, required)
                The timestamp defines start of a calendar event.
                Example: "2025-11-30T10:00:00Z"
              - `calendar_message.event_end` (string, required)
                The timestamp defines end of a calendar event.
                Example: "2025-11-30T11:00:00Z"
              - `calendar_message.event_title` (string, required)
                Title of a calendar event.
              - `calendar_message.fallback_url` (string, required)
                The URL that is opened when the user cannot open a calendar event directly or channel does not have support for this type.
              - `calendar_message.event_description` (string)
                Description of a calendar event.
            - Request location:
              - `share_location_message` (object)
              - `share_location_message.title` (string, required)
                The title is shown close to the button that leads to open a map to share a location.
              - `share_location_message.fallback_url` (string, required)
                The URL that is opened when channel does not have support for this type.
          - `choice_message.choices.postback_data` (any)
            An optional field. This data will be returned in the ChoiceResponseMessage. The default is message_id_{text, title}.
          - `choice_message.text_message` (object)
          - `choice_message.text_message.text` (string, required)
            The text to be sent.
          - `choice_message.message_properties` (object)
          - `choice_message.message_properties.whatsapp_footer` (string)
            Optional. Sets the text for the footer of a WhatsApp reply button or URL button message. Ignored for other channels.
        - Location:
          - `location_message` (object)
          - `location_message.coordinates` (object, required)
          - `location_message.coordinates.latitude` (number, required)
            The latitude.
          - `location_message.coordinates.longitude` (number, required)
            The longitude.
          - `location_message.title` (string, required)
            The title is shown close to the button or link that leads to a map showing the location. The title can be clickable in some cases.
          - `location_message.label` (string)
            Label or name for the position.
        - Media Message:
          - `media_message` (object)
          - `media_message.url` (string, required)
            Url to the media file.
          - `media_message.thumbnail_url` (string)
            An optional parameter. Will be used where it is natively supported.
          - `media_message.filename_override` (string)
            Overrides the media file name.
        - Template Message:
          - `template_message` (object)
          - `template_message.channel_template` (object)
            Optional. Channel specific template reference with parameters per channel.
The channel template if exists overrides the omnichannel template.
At least one of channel_template or omni_template needs to be present.
The key in the map must point to a valid conversation channel as
defined by the enum ConversationChannel.
          - `template_message.omni_template` (object)
            The referenced template can be an omnichannel template stored in Conversation API Template Store as an AppMessage. You may also reference external channel-specific templates, such as a WhatsApp Business Template. Note that channel-specific template references are not supported when populating the explicit_channel_omni_message field.
          - `template_message.omni_template.version` (string, required)
            Used to specify what version of a template to use. Required when using omni_channel_override and omni_template fields.
This will be used in conjunction with language_code. Note that, when referencing omni-channel templates using the [Sinch Customer Dashboard](https://dashboard.sinch.com/), the latest version of a given omni-template can be identified by populating this field with latest.
          - `template_message.omni_template.template_id` (string, required)
            The ID of the template. Note that, in the case of WhatsApp channel-specific templates, this field must be populated by the name of the template.
          - `template_message.omni_template.language_code` (string)
            The BCP-47 language code, such as en_US or sr_Latn.
For more information, see http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. English is the default language_code.
Note that, while many API calls involving templates accept either the dashed format (en-US) or the underscored format (en_US), some channel specific templates (for example, WhatsApp channel-specific templates) only accept the underscored format. Note that this field is required for WhatsApp channel-specific templates.
          - `template_message.omni_template.parameters` (object)
            Required if the template has parameters. Concrete values must
be present for all defined parameters
in the template. Parameters can be different for
different versions and/or languages of the template.
        - Text:
          - `text_message` (object)
          - `text_message.text` (string, required)
            The text to be sent.
        - List:
          - `list_message` (object)
          - `list_message.title` (string, required)
            A title for the message that is displayed near the products or choices.
          - `list_message.sections` (array, required)
            List of ListSection objects containing choices to be presented in the list message.
          - `list_message.sections.items` (array, required) — one of:
            - Choice:
              - `choice` (object, required)
                A message component for interactive messages, containing a choice.
              - `choice.title` (string, required)
                Required parameter. Title for the choice item.
              - `choice.description` (string)
                Optional parameter. The description (or subtitle) of this choice item.
              - `choice.media` (object)
                Optional parameter. The media of this choice item.
              - `choice.media.url` (string, required)
                Url to the media file.
              - `choice.media.thumbnail_url` (string)
                An optional parameter. Will be used where it is natively supported.
              - `choice.media.filename_override` (string)
                Overrides the media file name.
              - `choice.postback_data` (string)
                Optional parameter. Postback data that will be returned in the MO if the user selects this option.
            - Product:
              - `product` (object, required)
                A message component for interactive messages, containing a product.
              - `product.id` (string, required)
                Required parameter. The ID for the product.
              - `product.marketplace` (string, required)
                Required parameter. The marketplace to which the product belongs.
                Example: "FACEBOOK"
              - `product.quantity` (integer)
                Output only. The quantity of the chosen product.
              - `product.item_price` (number)
                Output only. The price for one unit of the chosen product.
              - `product.currency` (string)
                Output only. The currency of the item_price.
          - `list_message.sections.title` (string)
            Optional parameter. Title for list section.
          - `list_message.description` (string)
            This is an optional field, containing a description for the message.
          - `list_message.media` (object)
          - `list_message.media.url` (string, required)
            Url to the media file.
          - `list_message.media.thumbnail_url` (string)
            An optional parameter. Will be used where it is natively supported.
          - `list_message.media.filename_override` (string)
            Overrides the media file name.
          - `list_message.message_properties` (object)
            Additional properties for the message. Required if sending a product list message.
          - `list_message.message_properties.catalog_id` (string)
            Required if sending a product list message. The ID of the catalog to which the products belong.
          - `list_message.message_properties.menu` (string)
            Optional. Sets the text for the menu of a choice list message.
          - `list_message.message_properties.whatsapp_header` (string)
            Optional. Sets the text for the header of a WhatsApp choice list message. Ignored for other channels.
        - Contact Info:
          - `contact_info_message` (object)
          - `contact_info_message.name` (object, required)
            Name information of the contact.
          - `contact_info_message.name.full_name` (string, required)
            Full name of the contact
          - `contact_info_message.name.first_name` (string)
            First name.
          - `contact_info_message.name.last_name` (string)
            Last name.
          - `contact_info_message.name.middle_name` (string)
            Middle name.
          - `contact_info_message.name.prefix` (string)
            Prefix before the name. e.g. Mr, Mrs, Dr etc.
          - `contact_info_message.name.suffix` (string)
            Suffix after the name.
          - `contact_info_message.phone_numbers` (array, required)
            Phone numbers of the contact
          - `contact_info_message.phone_numbers.phone_number` (string, required)
            Phone number with country code included.
          - `contact_info_message.phone_numbers.type` (string)
            Phone number type, e.g. WORK or HOME.
          - `contact_info_message.addresses` (array)
            Physical addresses of the contact
          - `contact_info_message.addresses.city` (string)
            City Name
          - `contact_info_message.addresses.country` (string)
            Country Name
          - `contact_info_message.addresses.state` (string)
            Name of a state or region of a country.
          - `contact_info_message.addresses.zip` (string)
            Zip/postal code
          - `contact_info_message.addresses.type` (string)
            Address type, e.g. WORK or HOME
          - `contact_info_message.addresses.country_code` (string)
            Two letter country code.
          - `contact_info_message.email_addresses` (array)
            Email addresses of the contact
          - `contact_info_message.email_addresses.email_address` (string, required)
            Email address.
          - `contact_info_message.email_addresses.type` (string)
            Email address type. e.g. WORK or HOME.
          - `contact_info_message.organization` (object)
            Organization information of the contact.
          - `contact_info_message.organization.company` (string)
            Company name
          - `contact_info_message.organization.department` (string)
            Department at the company
          - `contact_info_message.organization.title` (string)
            Corporate title, e.g. Software engineer
          - `contact_info_message.urls` (array)
            URLs/websites associated with the contact
          - `contact_info_message.urls.url` (string, required)
            The URL to be referenced
          - `contact_info_message.urls.type` (string)
            Optional. URL type, e.g. Org or Social
          - `contact_info_message.birthday` (string)
            Date of birth in YYYY-MM-DD format.
      - `app_message.explicit_channel_message` (object)
        Allows you to specify a channel and define a corresponding channel specific message payload that will override the standard Conversation API message types. The key in the map must point to a valid conversation channel as defined in the enum ConversationChannel. The message content must be provided in a string format. You may use the [transcoding endpoint](https://developers.sinch.com/docs/conversation/api-reference/conversation/tag/Transcoding/) to help create your message. For more information about how to construct an explicit channel message for a particular channel, see that [channel's corresponding documentation](https://developers.sinch.com/docs/conversation/channel-support/) (for example, using explicit channel messages with [the WhatsApp channel](https://developers.sinch.com/docs/conversation/channel-support/whatsapp/message-support/#explicit-channel-messages)).
      - `app_message.explicit_channel_omni_message` (object)
        Override the message's content for specified channels. The key in the map must point to a valid conversation channel as defined in the enum ConversationChannel. The content defined under the specified channel will be sent on that channel.
      - `app_message.channel_specific_message` (object)
        Channel specific messages, overriding any transcoding. The structure of this property is more well-defined than the open structure of the explicit_channel_message property, and may be easier to use.
The key in the map must point to a valid conversation channel as defined in the enum ConversationChannel.
      - `app_message.agent` (object)
        Represents an agent that is involved in a conversation.
      - `app_message.agent.display_name` (string)
        Agent's display name
      - `app_message.agent.type` (string)
        Agent's classification. It can be UNKNOWN_AGENT_TYPE, HUMAN or BOT.
        Enum: "UNKNOWN_AGENT_TYPE", "HUMAN", "BOT"
      - `app_message.agent.picture_url` (string)
        The Agent's picture url.
    - Contact Message:
      - `contact_message` (object) — one of:
        A message originating from a contact.
        - Channel Specific Message:
          - `channel_specific_message` (object)
            Example: {"nfm_reply":{"summary":"WhatsApp NFM Reply Channel Specific Contact Message Example","value":{"channel_specific_message":{"message_type":"nfm_reply","message":{"type":"nfm_reply","nfm_reply":{"name":"flow","response_json":"{\"flow_token\": \"<FLOW_TOKEN>\", \"optional_param1\": \"<value1>\", \"optional_param2\": \"<value2>\"}","body":"Sent"}}}}}}
          - `channel_specific_message.message_type` (string)
            The message type.
            Enum: "nfm_reply"
          - `channel_specific_message.message` (any)
            The message content.
            - `type` (string, required)
              The interactive message type.
              Enum: same as `channel_specific_message.message_type` in "Channel Specific Message" (1 values)
            - `nfm_reply` (object, required)
              The interactive nfm reply message.
            - `nfm_reply.name` (string, required)
              The nfm reply message type.
              Enum: "flow", "address_message"
            - `nfm_reply.response_json` (string, required)
              The JSON specific data.
            - `nfm_reply.body` (string, required)
              The message body.
        - Choice Response:
          - `choice_response_message` (object)
          - `choice_response_message.message_id` (string, required)
            The message id containing the choice.
          - `choice_response_message.postback_data` (string, required)
            The postback_data defined in the selected choice.
        - Fallback:
          - `fallback_message` (object)
          - `fallback_message.raw_message` (string)
            Optional. The raw fallback message if provided by the channel.
          - `fallback_message.reason` (object)
          - `fallback_message.reason.code` (string)
            Enum: "UNKNOWN", "INTERNAL_ERROR", "RATE_LIMITED", "RECIPIENT_INVALID_CHANNEL_IDENTITY", "RECIPIENT_NOT_REACHABLE", "RECIPIENT_NOT_OPTED_IN", "OUTSIDE_ALLOWED_SENDING_WINDOW", "CHANNEL_FAILURE", "CHANNEL_BAD_CONFIGURATION", "CHANNEL_CONFIGURATION_MISSING", "MEDIA_TYPE_UNSUPPORTED", "MEDIA_TOO_LARGE", "MEDIA_NOT_REACHABLE", "NO_CHANNELS_LEFT", "TEMPLATE_NOT_FOUND", "TEMPLATE_INSUFFICIENT_PARAMETERS", "TEMPLATE_NON_EXISTING_LANGUAGE_OR_VERSION", "DELIVERY_TIMED_OUT", "DELIVERY_REJECTED_DUE_TO_POLICY", "CONTACT_NOT_FOUND", "BAD_REQUEST", "UNKNOWN_APP", "NO_CHANNEL_IDENTITY_FOR_CONTACT", "CHANNEL_REJECT", "NO_PERMISSION", "NO_PROFILE_AVAILABLE", "UNSUPPORTED_OPERATION"
          - `fallback_message.reason.description` (string)
            A textual description of the reason.
          - `fallback_message.reason.sub_code` (string)
            Enum: "UNSPECIFIED_SUB_CODE", "ATTACHMENT_REJECTED", "MEDIA_TYPE_UNDETERMINED", "INACTIVE_SENDER"
          - `fallback_message.reason.channel_code` (string)
            Error code forwarded directly from the channel. Useful in case of unmapped or channel specific errors. Currently only supported on the WhatsApp channel.
        - Location:
          - `location_message` (object)
          - `location_message.coordinates` (object, required)
          - `location_message.coordinates.latitude` (number, required)
            The latitude.
          - `location_message.coordinates.longitude` (number, required)
            The longitude.
          - `location_message.title` (string, required)
            The title is shown close to the button or link that leads to a map showing the location. The title can be clickable in some cases.
          - `location_message.label` (string)
            Label or name for the position.
        - Media Card:
          - `media_card_message` (object)
          - `media_card_message.url` (string, required)
            Url to the media file.
          - `media_card_message.caption` (string)
            Caption for the media on supported channels.
        - Media Message:
          - `media_message` (object)
          - `media_message.url` (string, required)
            Url to the media file.
          - `media_message.thumbnail_url` (string)
            An optional parameter. Will be used where it is natively supported.
          - `media_message.filename_override` (string)
            Overrides the media file name.
        - Product Response Message:
          - `product_response_message` (object)
          - `product_response_message.products` (array)
            The selected products.
          - `product_response_message.products.id` (string, required)
            Required parameter. The ID for the product.
          - `product_response_message.products.marketplace` (string, required)
            Required parameter. The marketplace to which the product belongs.
            Example: "FACEBOOK"
          - `product_response_message.products.quantity` (integer)
            Output only. The quantity of the chosen product.
          - `product_response_message.products.item_price` (number)
            Output only. The price for one unit of the chosen product.
          - `product_response_message.products.currency` (string)
            Output only. The currency of the item_price.
          - `product_response_message.title` (string)
            Optional parameter. Text that may be sent with selected products.
          - `product_response_message.catalog_id` (string)
            Optional parameter. The catalog id that the selected products belong to.
        - Text:
          - `text_message` (object)
          - `text_message.text` (string, required)
            The text to be sent.
      - `contact_message.reply_to` (object)
      - `contact_message.reply_to.message_id` (string, required)
        Required. The Id of the message that this is a response to

  - `messages.accept_time` (string)
    The time Conversation API processed the message.

  - `messages.channel_identity` (object)
    A unique identity of message recipient on a particular channel.
For example, the channel identity on SMS, WHATSAPP or VIBERBM is a MSISDN phone number.

  - `messages.channel_identity.identity` (string, required)
    The channel identity. This will differ from channel to channel. For example, a phone number for SMS, WhatsApp, and Viber Business.

  - `messages.channel_identity.channel` (string, required)
    The identifier of the channel you want to include. Must be one of the enum values.
    Enum: same as `channel` (13 values)

  - `messages.channel_identity.app_id` (string)
    Required if using a channel that uses app-scoped channel identities. Currently, FB Messenger, Instagram, LINE, and WeChat use app-scoped channel identities, which means contacts will have different channel identities on different Conversation API apps. These can be thought of as virtual identities that are app-specific and, therefore, the app_id must be included in the API call.

  - `messages.contact_id` (string)
    The ID of the contact.

  - `messages.conversation_id` (string)
    The ID of the conversation.

  - `messages.direction` (string)
    The direction of the message flow, indicating whether the message was sent to or from the Conversation API app.
    Enum: same as `direction` (2 values)

  - `messages.id` (string)
    The ID of the message.

  - `messages.metadata` (string)
    Optional. Metadata associated with the contact.
Up to 1024 characters long.

  - `messages.injected` (boolean)
    Flag for whether this message was injected.

  - `messages.sender_id` (string)
    For Contact Messages (MO messages), the sender ID represents the recipient to which the message was sent. This may be a phone number (in the case of SMS and MMS) or a unique ID (in the case of WhatsApp). This is field is not supported on all channels, nor is it supported for MT messages.

  - `messages.processing_mode` (string)
    Whether or not Conversation API should store contacts and conversations for the app. For more information, see [Processing Modes](https://developers.sinch.com/docs/conversation/processing-modes/).
    Enum: "CONVERSATION", "DISPATCH"

  - `next_page_token` (string)
    Token that should be included in the next request to fetch the next page.

## Response 400 fields (application/json):

  - `error` (object)

  - `error.code` (integer)

  - `error.details` (array)

  - `error.details.type_url` (string)

  - `error.details.value` (string)

  - `error.message` (string)

  - `error.status` (string)