> ## Documentation Index > Fetch the complete documentation index at: https://www.quo.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # List conversations > Get a paginated list of the organization's conversations, most recently created first. ## OpenAPI ````yaml https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-2026-03-30-prod.json get /conversations openapi: 3.1.0 info: title: Quo Public API version: 1.0.0 description: API for connecting with Quo. contact: name: Quo Support email: support@quo.com url: https://support.quo.com/ termsOfService: https://www.quo.com/terms servers: - description: Production server url: https://api.quo.com security: - apiKey: [] tags: - description: Operations related to the organization's A2P registration name: A2P Registration - description: Operations related to calls placed by an AI agent name: Agent Calls - description: Operations related to text conversations held by an AI agent name: Agent Conversations - description: Operations related to calls name: Calls - description: >- Operations related to call summaries, including AI-generated summaries and Sona voice assistant summaries name: Call Summaries - description: >- Operations related to call transcripts, including AI-generated transcripts and Sona voice assistant transcripts name: Call Transcripts - description: Operations related to contacts name: Contacts - description: Operations related to contact shares name: Contact Shares - description: Operations related to contact notes name: Contact Notes - description: Operations related to contact properties name: Contact Properties - description: Operations related to conversations name: Conversations - description: Operations related to workspace invitations name: Invites - description: Operations related to text messages name: Messages - description: Operations related to the organization name: Organization - description: Operations related to phone numbers name: Phone Numbers - description: Operations related to users name: Users - description: Operations related to webhooks name: Webhooks - description: >- Operations related to webhook events, including delivery history and test events name: Webhook Events paths: /conversations: get: tags: - Conversations summary: List conversations description: >- Get a paginated list of the organization's conversations, most recently created first. operationId: listConversationsHeaderVersioned parameters: - in: query name: phoneNumberId required: false schema: anyOf: - type: string pattern: ^PN(.*)$ - type: object required: - in properties: in: type: array items: type: string pattern: ^PN(.*)$ description: >- Match conversations on any of these Quo phone number IDs (max 100). examples: - PN123abc,PN456def maxItems: 100 additionalProperties: false description: >- Only return conversations on this Quo phone number ID, such as `phoneNumberId=PN123abc`. To match any of several, use `phoneNumberId[in]=PN123abc,PN456def` (max 100). Matches the Quo phone number only, not participant numbers. examples: - PN123abc style: deepObject explode: true example: PN123abc - in: query name: createdAt required: false schema: type: object properties: gte: type: string format: date-time lte: type: string format: date-time additionalProperties: false description: >- Bound the results by creation time (inclusive), in ISO 8601 format: `createdAt[gte]=2022-01-01T00:00:00Z&createdAt[lte]=2022-02-01T00:00:00Z`. style: deepObject explode: true - in: query name: updatedAt required: false schema: type: object properties: gte: type: string format: date-time lte: type: string format: date-time additionalProperties: false description: >- Bound the results by last-updated time (inclusive), in ISO 8601 format: `updatedAt[gte]=2022-01-01T00:00:00Z&updatedAt[lte]=2022-02-01T00:00:00Z`. style: deepObject explode: true - in: query name: sort required: false schema: type: string description: >- A single field:direction pair. Allowed fields: createdAt, updatedAt. Direction must be asc or desc. examples: - createdAt:desc example: createdAt:desc - in: query name: limit required: false schema: type: integer description: Max number of items to return per page. default: 10 maximum: 50 minimum: 1 - in: query name: after required: false schema: type: string examples: - eyJsYXN0SWQiOiJVU211a09NaXBhIn0 example: eyJsYXN0SWQiOiJVU211a09NaXBhIn0 - in: header name: Quo-Api-Version required: true schema: type: string enum: - '2026-03-30' description: 'API version header. Supported values: 2026-03-30' responses: '200': description: OK content: application/json: schema: type: object required: - data - nextCursor properties: data: type: array items: type: object required: - createdAt - deletedAt - id - lastActivityAt - lastActivityId - mutedUntil - name - participants - phoneNumberId - snoozedUntil - updatedAt properties: createdAt: anyOf: - type: string format: date-time - type: 'null' deletedAt: anyOf: - type: string format: date-time - type: 'null' id: description: The unique identifier of the conversation. examples: - CN123abc example: CN123abc type: string pattern: ^CN(.*)$ lastActivityAt: anyOf: - type: string format: date-time - type: 'null' lastActivityId: anyOf: - description: >- The unique identifier of the most recent activity in the conversation. examples: - AC123abc example: AC123abc type: string pattern: ^AC(.*)$ - type: 'null' mutedUntil: anyOf: - type: string format: date-time - type: 'null' name: anyOf: - type: string description: >- The custom name of the conversation. Will be null if no custom name is set. examples: - Chat with customer example: Chat with customer - type: 'null' participants: type: array items: type: string description: >- A phone number in E.164 format, a short code (5-6 digits, no country code), or a non-phone-number caller ID (`Anonymous`, `Blocked`, or `Restricted`). examples: - '+15555555555' - '12345' - Anonymous pattern: >- ^(?:\+[1-9]\d{1,14}|\d{5,6}|[aA](?:nonymous|NONYMOUS)|[bB](?:locked|LOCKED)|[rR](?:estricted|ESTRICTED))$ example: '+15555555555' description: >- An array of phone numbers involved in the call, excluding your Quo number. Each number is either a phone number in E.164 format, a short code (5-6 digits, no country code), or a non-phone-number caller ID (`Anonymous`, `Blocked`, or `Restricted`). phoneNumberId: description: >- The unique identifier of the Quo phone number associated with the conversation. examples: - PN123abc example: PN123abc type: string pattern: ^PN(.*)$ snoozedUntil: anyOf: - type: string format: date-time - type: 'null' updatedAt: anyOf: - type: string format: date-time - type: 'null' nextCursor: anyOf: - type: string - type: 'null' description: >- Cursor for the next page, or null when there are no more pages. examples: - eyJsYXN0SWQiOiJVU211a09NaXBhIn0 example: eyJsYXN0SWQiOiJVU211a09NaXBhIn0 '400': description: Bad Request content: application/json: schema: type: object required: - message - docs - title properties: message: type: string docs: type: string const: https://quo.com/docs title: type: string const: Bad Request trace: type: string errors: type: array items: type: object required: - path - message - schema properties: path: type: string message: type: string value: {} schema: type: object required: - type properties: type: type: string example: message: The input was invalid docs: https://quo.com/docs title: Bad Request errors: - path: /conversationId message: Expected string to match '^CN(.*)$' value: abc123 schema: type: TemplateLiteral pattern: ^CN(.*)$ '401': description: Unauthorized content: application/json: schema: type: object required: - message - docs - title properties: message: type: string docs: type: string const: https://quo.com/docs title: type: string const: Unauthorized trace: type: string errors: type: array items: type: object required: - path - message - schema properties: path: type: string message: type: string value: {} schema: type: object required: - type properties: type: type: string example: message: Unauthorized docs: https://quo.com/docs title: Unauthorized trace: '6897907457496870895' '403': description: Forbidden content: application/json: schema: type: object required: - message - docs - title properties: message: type: string docs: type: string const: https://quo.com/docs title: type: string const: Forbidden trace: type: string errors: type: array items: type: object required: - path - message - schema properties: path: type: string message: type: string value: {} schema: type: object required: - type properties: type: type: string example: message: User is forbidden to perform this action docs: https://quo.com/docs title: Forbidden trace: '6897907457496870895' '404': description: Not Found content: application/json: schema: type: object required: - message - docs - title properties: message: type: string docs: type: string const: https://quo.com/docs title: type: string const: Not Found trace: type: string errors: type: array items: type: object required: - path - message - schema properties: path: type: string message: type: string value: {} schema: type: object required: - type properties: type: type: string example: message: Conversation not found docs: https://quo.com/docs title: Not Found trace: '6897907457496870895' '500': description: Unknown Error content: application/json: schema: type: object required: - message - docs - title properties: message: type: string docs: type: string const: https://quo.com/docs title: type: string const: Unknown trace: type: string errors: type: array items: type: object required: - path - message - schema properties: path: type: string message: type: string value: {} schema: type: object required: - type properties: type: type: string example: message: We have encountered an unknown error docs: https://quo.com/docs title: Unknown trace: '6897907457496870895' security: - apiKey: [] components: securitySchemes: apiKey: in: header name: Authorization type: apiKey ````