> ## Documentation Index > Fetch the complete documentation index at: https://docs.shortext.ny-corp.io/llms.txt > Use this file to discover all available pages before exploring further. # List conversations > Most recent message first, 50 per page. ## OpenAPI ````yaml /api-reference/v2.0/openapi.json get /conversations openapi: 3.1.0 info: title: Shortext API description: >- **Versioning**: every version is a frozen contract. A released version only receives additive changes (new endpoints, new optional fields, new response fields); anything breaking ships in a new version. Responses carry `X-Shortext-Api-Version`. When a version is scheduled for removal, responses also carry `Deprecation` and `Sunset` headers; after the sunset date the version answers HTTP 410. The list of versions and their status is available at `GET /api/versions`. **Responses**: always HTTP 200. Check `success` and `code` (`1000` = success), see `ApiEnvelope`. On failure, `trace_id` identifies the request for support. version: '2.0' servers: - url: https://shortext.ny-corp.io/api/v2.0 security: [] tags: - name: Agents description: Agents - name: Channels description: Channels - name: Conversations description: Conversations - name: Account description: Account - name: Templates description: Templates - name: Hosted sessions description: Hosted sessions - name: Webhooks description: Webhooks paths: /conversations: get: tags: - Conversations summary: List conversations description: Most recent message first, 50 per page. operationId: listConversations parameters: - name: page in: query required: false schema: type: integer - name: status in: query required: false schema: type: string enum: - active - archived - name: agent_id in: query description: Conversations of this agent's channels; "none" for detached channels required: false schema: type: string - name: channel in: query description: Channel type required: false schema: type: string enum: - whatsapp - mail - shortext - name: channel_id in: query description: 'With `channel`: one channel (the channel_id of the webhooks)' required: false schema: type: string - name: contact in: query description: Contact identifier (phone, email, or your own id for Shortext) required: false schema: type: string - name: assignee in: query description: >- "me" (user tokens only), "none", or a member id (GET /conversations/assignees) required: false schema: type: string - name: ticket_id in: query description: The conversation of a ticket (ticket reference) required: false schema: type: string - name: updated_since in: query description: Last message at or after this date required: false schema: type: string format: date-time responses: '200': description: >- Always HTTP 200: the outcome is in `success` and `code` (absolute value of the response code). content: application/json: schema: allOf: - $ref: '#/components/schemas/ApiEnvelope' - properties: body: allOf: - $ref: '#/components/schemas/ApiPage' - properties: data: type: array items: $ref: '#/components/schemas/Conversation' type: object type: object security: - bearerAuth: [] components: schemas: ApiEnvelope: properties: success: type: boolean example: true code: type: integer example: 1000 message: type: string example: Request success. body: description: Endpoint payload, null when there is none token: description: Present only on authentication routes type: - string - 'null' trace_id: description: Present only when success is false type: - string - 'null' type: object ApiPage: description: >- A page of results: `data` holds the items. Ask another page with `?page=` properties: current_page: type: integer example: 1 data: type: array items: {} per_page: type: integer example: 50 total: type: integer example: 120 last_page: type: integer example: 3 from: type: - integer - 'null' to: type: - integer - 'null' first_page_url: type: string last_page_url: type: string next_page_url: type: - string - 'null' prev_page_url: type: - string - 'null' path: type: string type: object Conversation: properties: id: description: The conversation_id of the webhooks type: string status: description: '`active`: a session is open; `archived`: replying opens a new one' type: string enum: - active - archived channel: properties: type: type: string enum: - whatsapp - mail - shortext id: description: The channel_id of the webhooks type: string type: object agent: description: Agent answering on the channel; null when the channel is detached properties: id: type: string name: type: string type: - object - 'null' contact: properties: identifier: type: string identifier_type: type: string profile: type: object country: type: object type: object session: description: Current session; null when archived properties: started_at: type: string format: date-time ends_at: type: - string - 'null' format: date-time handover: description: 'A human took over: the AI agent does not answer' type: boolean handover_at: type: - string - 'null' format: date-time assignee: oneOf: - $ref: '#/components/schemas/Member' - type: 'null' type: - object - 'null' last_message_at: type: - string - 'null' format: date-time created_at: type: string format: date-time type: object Member: description: User of the company (dashboard, mobile app) properties: id: type: string example: USR-XXXXX name: type: string type: object securitySchemes: bearerAuth: type: http description: >- Company API key, sent as `Authorization: Bearer `. Create it in the dashboard (Developer > API Keys) with the permissions the integration needs. scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.