---
title: "Conversation information"
method: GET
path: "/conversations/{conversation_id}"
tags: ["Messages"]
---

# Conversation information

`GET /conversations/{conversation_id}`

This endpoint returns all information on a specific Conversation.

## Path parameters

- `conversation_id` integer, required — The id of the conversation to fetch

## Response `200`

OK

- object — The detail of a conversation.
  - `id` integer
  - `consumer_img` string, url, nullable — The url of the consumer's profile picture
  - `consumer_name` string, nullable — The name of the consumer, can be empty. The format may differ depending on the platform of contact (ex: "John Doe", "John Doe (@johndoe)", "@johndoe", "", ...).
  - `consumer_phone_number` string, nullable — The phone number of the consumer, formatted in E.164 international format (ex: "+33612345678").
  - `consumer_email` string, nullable — The email of the consumer.
  - `last_message` Message
    - `id` integer — The id of the message.
    - `conversation_id` integer — The id of the parent conversation.
    - `date` string — The date at which the message was sent or received, in the ISO 8601 format (ex: "2023-01-31 16:22:17.327878+00:00").
    - `content_type` 'Text' | 'Image' | 'Video' | 'Audio' | 'Document' | 'IgStoryReply' | 'IgStoryMention' | 'Unsupported' — The type of the message: - "Text" describes a simple text message. - "Image" describes a message that only contains an image. - "IgStoryReply" (for "Instagram" conversations) describes a notification of reply to an Instagram story. - "IgStoryMention" (for "Instagram" conversations) describes a notification of a mention in an Instagram story. - "Unsupported" describes a message whose content is not supported. ⚠️ New values may be added to this enum without prior notice and without following the classic depreciation cycle. It is up to you to gracefully handle the case where new values are added. We recommend showing a "Unhandled content" placeholder to the user in place of the message ⚠️
    - `sender_type` 'User' | 'Consumer' | 'Metadata' — Describes the person that sent the Message: - "User" indicates that the message was sent as the Business. Such messages can be sent by a Partoo user, via API, or directly on the messaging platform. - "Consumer" indicates that the message was sent by a consumer, a client that wants to get in touch with the business. - "Metadata" is reserved for special messages that appear in the Partoo inbox. They only give contextual information about the conversation, and are not shown to the consumer. ⚠️ New values may be added to this enum without prior notice and without following the classic depreciation cycle. It is up to you to gracefully handle the case where new values are added. We recommend ignoring messages with unhandled sender_type ⚠️
    - `sender_label` string, nullable — Name of the person sending the message
    - `status` 'Sending' | 'Success' | 'Failed' — The delivery status of the message. Messages send via Partoo are created with the status "Sending", and propagated to the messaging channel. If the message is sent successfully, the status is changed to "Success". If the messaging channel fails to send the message, the status changed to "Failed". A failed message can be retried using the [/retry endpoint](/api-reference/messages/retry-send-message).
    - `is_deleted` boolean — If the message has been deleted by the consumer on the messaging channel (for now, only "Instagram" messages can be deleted).
    - `is_automated` boolean — If the message was sent by a Partoo automation (chatbot, ...).
    - `content` union
      - string — The text of the message.
      - string, url — The url of the image.
      - VideoMessageContent
        - `url` string, url — The url of the video.
        - `file_name` string, nullable — Name of the video file.
      - AudioMessageContent
        - `url` string, url — The url of the audio.
        - `file_name` string, nullable — Name of the audio file.
      - DocumentMessageContent
        - `url` string, url — The url of the document.
        - `file_name` string, nullable — Name of the document file.
      - IgStoryReplyMessageContent
        - `url` string, url — The url of the story that received the reply.
        - `content` string — Text of the reply, or url of the image.
        - `content_type` 'Image' | 'Text' — The type of content of ther reply.
        - `id` string — The Instagram ID of the story.
      - string, url — The url of the story mentionned.
      - UnsupportedMessageContent
        - `type` 'video' | 'audio' | 'unknown'
      - 'Solving'
      - 'Reopening'
    - `user_id` string, nullable — For "User" messages sent via the Partoo application, the id of the user that sent the message.
    - `custom_channel` CustomChannelMessage
      - `external_message_id` string — The unique id of the message in your system.
  - `is_read` boolean — If the last message received was read. This property is scoped to the user who performs the request. Multiple partoo users can have a different is_read value for the same conversation. is_read is always false in webhook payloads.
  - `status` 'Open' | 'Closed' — If Open, it is possible to send a message in the conversation, else not. A conversation can be Closed if it is expired.
  - `created_at` string — The date of creation of the conversation, in the ISO 8601 format (ex: "2023-01-31 16:22:17.327878+00:00").
  - `has_one_user_message` boolean — If the conversation has at least one message sent by a Partoo user.
  - `business` object — Some basic information about the business that the conversation is associated with.
    - `id` string
    - `name` string, nullable
    - `city` string, nullable
    - `zipcode` string, nullable
    - `country` string, nullable
    - `formatted_address` string, nullable
  - `messaging_partner` 'Google' | 'Facebook' | 'Instagram' | 'SMS' | 'Whatsapp' | 'Custom' | 'Livechat' — The channel that the message is being sent to/from. ⚠️ New values may be added to this enum without prior notice and without following the classic depreciation cycle. It is up to you to gracefully handle the case where new values are added.
  - `issues` ConversationIssue[] — The list of issues that affect the conversation. The issues represent setup problem that the business may have with a messaging channel. It is not possible to send messages on a conversation that has issues. ⚠️ New values may be added to this enum without prior notice and without following the classic depreciation cycle. It is up to you to gracefully handle the case where new values are added.
  - `first_message_date` string — The date at which the first message of the conversation was received, in the ISO 8601 format (ex: "2023-01-31 16:22:17.327878+00:00").
  - `is_expired` boolean — If the conversation has expired. A conversation expires if the consumer has not contacted the business for a certain amount of time. You cannot send messages to an expired conversation.
  - `is_solved` boolean — If the conversation has been solved. Conversations can be solved from our app or by updating conversation status to "closed".
  - `is_automated` boolean — If a Partoo chatbot is assigned to the conversation.
  - `assigned_user_id` string, nullable — The "user_id" of the user assigned to the conversation.
  - `custom_channel` CustomChannel
    - `id` string — The id of the custom channel.
    - `name` string — The name of the custom channel.
    - `icon` string — Url of the channel's icon.
    - `is_readonly` boolean — Set to `true` if the channel to be read-only (i.e., no replies via Partoo)
    - `external_conversation_id` string — The unique id of the conversation in your system.

## Other responses

- `401` — You are not authenticated
- `403` — You are not allowed to perform this action

---

[API](https://skmtc.net/partoo/apis/partoo-rest-api.md) · [All operations](https://skmtc.net/partoo/apis/partoo-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/partoo/partoo-rest-api/versions/3652d8b1a8b3/schema)