> ## Documentation Index > Fetch the complete documentation index at: https://docs.tied.com/llms.txt > Use this file to discover all available pages before exploring further. # Get messages > List all messages of a conversation ## OpenAPI ````yaml /api-reference/openapi.json get /api/v1/accounts/{account_id}/conversations/{conversation_id}/messages openapi: 3.0.4 info: title: Tied API description: >- The Tied REST API. Three families of endpoint, each with its own credential: **Application** for everything inside an account, **Platform** for provisioning accounts and users, and **Client** for acting as a contact from your own surface. version: 1.1.0 termsOfService: https://tied.com/legal contact: email: hello@tied.com license: name: MIT License url: https://opensource.org/licenses/MIT servers: - url: https://app.tied.com description: Tied cloud security: [] tags: - name: Account AgentBots description: Account-specific Agent Bots - name: Agents description: Agent management APIs - name: Canned Responses description: Pre-defined responses for common queries - name: Contacts description: Contact management APIs - name: Contact Labels description: Manage contact labels - name: Conversation Assignments description: Manage conversation assignments - name: Conversation Labels description: Manage conversation labels - name: Conversations description: Conversation management APIs - name: Custom Attributes description: Custom fields for contacts and conversations - name: Custom Filters description: Saved filters for conversations - name: Inboxes description: Communication channels setup - name: Integrations description: Third-party integrations - name: Messages description: Message management APIs - name: Profile description: User profile APIs - name: Reports description: Analytics and reporting APIs - name: Teams description: Team management APIs - name: Webhooks description: Event notification webhooks - name: Automation Rule description: Workflow automation rules - name: Help Center description: Knowledge base management - name: Contacts API description: Public contact APIs - name: Conversations API description: Public conversation APIs - name: Messages API description: Public message APIs - name: CSAT Survey Page description: Customer satisfaction survey - name: Account description: >- The authenticated user's own account — read and update account settings. Distinct from the Platform family's **Accounts**, which provisions accounts across an installation. - name: Audit Logs description: Read the account's audit trail - name: Inbox API description: Public inbox lookup by channel identifier - name: Labels description: >- Create and manage the account's labels. Applying one to a conversation or contact is a separate endpoint under those resources. - name: Macros description: >- Saved multi-step actions an agent — or an integration — can run against one or more conversations. - name: Campaigns description: Ongoing website campaigns and one-off SMS and WhatsApp sends. - name: Contact Notes description: Internal notes on a contact. Never visible to the contact. - name: Help Center Categories description: Categories group a portal's articles, one tree per allowed locale. - name: Help Center Articles description: The articles a portal publishes, and their draft and archived states. - name: Summary Reports description: Per-agent, per-team, per-inbox and per-label totals for a period, as JSON. - name: Live Reports description: Right-now queue counts. No date range — these describe the present. - name: CSAT description: >- The satisfaction ratings contacts have submitted, and the metrics computed from them. - name: Notifications description: >- The per-user notification feed, its read and snooze state, and the settings that decide what lands in it. - name: Conversation Participants description: >- The agents watching a conversation. Participants get notified about it without being assigned to it. - name: Draft Messages description: >- The unsent reply held for a conversation. Stored in Redis, one per conversation. - name: Search description: >- One search service across conversations, contacts, messages and Help Center articles. - name: Dashboard Apps description: Embedded pages that appear as a tab beside a conversation. - name: Assignment Policies description: How conversations are handed out, and which inbox uses which policy. - name: Files description: Storing a file so another endpoint can attach it. - name: Bot Flows description: >- Scripted conversation flows, their versions, and the publish and rollback that move between them. - name: Billing description: >- Credit balance, usage, invoices, spend controls and the provider-hosted payment flows. - name: AMB Templates description: >- Saved Apple Messages primitive payloads an agent can reuse from the composer. - name: AMB Onboarding description: The in-flight Apple Messages for Business registration for an account. - name: Widget Session description: Starting a widget session and reading the visitor it belongs to. - name: Widget Conversation description: The visitor's conversation and its messages. - name: Widget Context description: Campaigns, agents, labels, events and uploads for a widget session. - name: CSAT Survey description: The public, unauthenticated survey a contact answers from a link. - name: Workspace description: Scheduling and cancelling deletion of the whole workspace. paths: /api/v1/accounts/{account_id}/conversations/{conversation_id}/messages: parameters: - $ref: '#/components/parameters/account_id' - $ref: '#/components/parameters/conversation_id' get: tags: - Messages summary: Get messages description: List all messages of a conversation operationId: list-all-messages responses: '200': description: Success content: application/json: schema: type: object properties: meta: type: object properties: labels: type: array items: type: string additional_attributes: type: object contact: $ref: '#/components/schemas/contact' assignee: $ref: '#/components/schemas/agent' agent_last_seen_at: type: string format: date-time assignee_last_seen_at: type: string format: date-time nullable: true payload: type: array description: Array of messages items: $ref: '#/components/schemas/message' example: meta: labels: [] additional_attributes: {} contact: additional_attributes: {} custom_attributes: {} email: null id: 142 identifier: null name: Jen Park phone_number: null thumbnail: '' thumbnail_background_color: null domain_logo_avatar: false customer_verified: false blocked: false type: contact agent_last_seen_at: '2026-09-20T23:06:03.222Z' assignee_last_seen_at: null payload: - id: 559 content: Hello — trying the chat widget on our staging site. inbox_id: 4 conversation_id: 167 message_type: 0 content_type: text status: sent content_attributes: {} created_at: 1789945263 private: false source_id: null actor: null sender: additional_attributes: {} custom_attributes: {} email: null id: 142 identifier: null name: Jen Park phone_number: null thumbnail: '' thumbnail_background_color: null domain_logo_avatar: false customer_verified: false blocked: false type: contact - id: 560 content: >- I can walk you through either plan and what changes between them. inbox_id: 4 conversation_id: 167 message_type: 1 content_type: text status: sent content_attributes: {} created_at: 1789945383 private: false source_id: null actor: null sender: id: 1 name: Alex Rivera available_name: Alex Rivera avatar_url: '' type: user availability_status: offline thumbnail: /dashboard/images/default-contact-avatars/031.svg illustration_avatar: true accent_color: null '401': description: >- Unauthorized. A token that is present but invalid returns this shape; a request with no `api_access_token` header at all returns `{"errors": ["You need to sign in or sign up before continuing."]}`. content: application/json: schema: $ref: '#/components/schemas/error_message' '404': description: Conversation not found content: application/json: schema: $ref: '#/components/schemas/error_message' security: - userApiKey: [] components: parameters: account_id: in: path name: id schema: type: integer required: true description: The numeric ID of the account conversation_id: in: path name: conversation_id schema: type: integer required: true description: The numeric ID of the conversation schemas: contact: type: object properties: payload: type: array description: List of contacts items: type: object properties: additional_attributes: type: object description: >- The object containing additional attributes related to the contact availability_status: type: string description: The availability status of the contact email: type: string description: The email address of the contact id: type: integer description: The ID of the contact name: type: string description: The name of the contact phone_number: type: string description: The phone number of the contact blocked: type: boolean description: Whether the contact is blocked identifier: type: string description: The identifier of the contact thumbnail: type: string description: The thumbnail of the contact custom_attributes: type: object description: The custom attributes of the contact example: attribute_key: attribute_value signed_up_at: dd/mm/yyyy last_activity_at: type: integer description: The last activity at of the contact created_at: type: integer description: The created at of the contact contact_inboxes: type: array items: $ref: '#/components/schemas/contact_inboxes' description: Every channel identity this contact has been seen on. agent: type: object properties: id: type: integer description: The agent's numeric ID. account_id: type: integer description: The account the agent belongs to. availability_status: type: string enum: - available - busy - offline description: The availability status of the agent computed by Tied. auto_offline: type: boolean description: >- Whether the availability status of agent is configured to go offline automatically when away. confirmed: type: boolean description: Whether the agent has confirmed their email address. email: type: string description: The email of the agent available_name: type: string description: The available name of the agent name: type: string description: The name of the agent role: type: string enum: - agent - administrator description: The role of the agent thumbnail: type: string description: The thumbnail of the agent custom_role_id: type: integer description: The custom role id of the agent nullable: true provider: type: string description: How the agent signs in — `email` for a password login. avatar_url: type: string description: >- URL of an uploaded avatar. Empty when the agent has not uploaded one. illustration_avatar: type: boolean description: >- Whether `thumbnail` is one of the generated illustration avatars rather than an upload. accent_color: type: string nullable: true description: The agent's chosen dashboard accent colour. message: type: object properties: id: type: number description: The ID of the message content: type: string description: The text content of the message nullable: true account_id: type: number description: The ID of the account inbox_id: type: number description: The ID of the inbox conversation_id: type: number description: The ID of the conversation message_type: description: 0 = incoming, 1 = outgoing, 2 = activity, 3 = template. type: integer enum: - 0 - 1 - 2 - 3 created_at: type: integer description: The time at which message was created updated_at: description: >- ISO-8601 timestamp of the last update. Note this differs from `created_at` on the same object, which is unix epoch seconds. type: string format: date-time nullable: true private: type: boolean description: The flags which shows whether the message is private or not status: type: string enum: - sent - delivered - read - failed description: The status of the message source_id: type: string description: The source ID of the message nullable: true content_type: type: string enum: - text - input_select - cards - form description: The type of the template message content_attributes: type: object description: The content attributes for each content_type sender_type: description: >- The class of the sender, capitalised to match the underlying record type. type: string enum: - Contact - User - AgentBot nullable: true sender_id: type: number description: The ID of the sender external_source_ids: type: object description: The external source IDs of the message additional_attributes: type: object description: The additional attributes of the message processed_message_content: type: string description: The processed message content nullable: true sentiment: type: object description: The sentiment of the message conversation: type: object description: The conversation object attachment: type: object description: The file object attached to the image sender: type: object description: User/Agent/AgentBot object error_message: type: object description: >- The shape returned by `render_unauthorized`, `render_not_found_error` and `render_could_not_create_error`. properties: error: type: string description: A single human-readable message. example: Resource could not be found required: - error contact_inboxes: type: object properties: source_id: type: string description: Contact Inbox Source Id inbox: $ref: '#/components/schemas/inbox_contact' inbox_contact: type: object properties: id: type: number description: ID of the inbox avatar_url: type: string description: The avatar image of the inbox channel_id: type: number description: The ID of the channel nullable: true name: type: string description: The name of the inbox channel_type: type: string description: The type of the inbox provider: type: string description: The provider of the inbox nullable: true securitySchemes: userApiKey: type: apiKey in: header name: api_access_token description: >- This token can be obtained by visiting the profile page or via rails console. Provides access to endpoints based on the user permissions levels. This token can be saved by an external system when user is created via API, to perform activities on behalf of the user. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.