> ## 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 messages > Retrieve a chronological list of messages exchanged between your Quo number and specified participants, with support for filtering and pagination. ## OpenAPI ````yaml https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json get /v1/messages 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 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 conversations name: Conversations - description: Operations related to text messages name: Messages - description: Operations related to phone numbers name: Phone Numbers - description: Operations related to users name: Users - description: Operations related to webhooks name: Webhooks paths: /v1/messages: get: tags: - Messages summary: List messages description: >- Retrieve a chronological list of messages exchanged between your Quo number and specified participants, with support for filtering and pagination. operationId: listMessages_v1 parameters: - in: query name: phoneNumberId required: true schema: description: >- The unique identifier of the Quo number used to send or receive the messages. PhoneNumberID can be retrieved via the Get Phone Numbers endpoint. examples: - OP123abc pattern: ^PN(.*)$ type: string example: OP123abc - in: query name: userId required: false schema: description: The unique identifier of the user the message was sent from. examples: - US123abc pattern: ^US(.*)$ type: string example: US123abc - in: query name: participants required: true schema: description: >- Array of phone numbers involved in the conversation, excluding your Quo number, in E.164 format. Passing a single participant will retrieve their conversation messages. Passing multiple participants will retrieve group conversation messages. maxItems: 10 examples: - '+15555555555' type: array items: description: A phone number in E.164 format, including the country code. examples: - '+15555555555' pattern: ^\+[1-9]\d{1,14}$ type: string example: '+15555555555' - in: query name: since required: false schema: deprecated: true description: >- DEPRECATED, use "createdAfter" or "createdBefore" instead. "since" currently behaves as "createdBefore" and will be removed in an upcoming release. examples: - '2022-01-01T00:00:00Z' format: date-time type: string example: '2022-01-01T00:00:00Z' - in: query name: createdAfter required: false schema: description: >- Filter results to only include messages created after the specified date and time, in ISO_8601 format. examples: - '2022-01-01T00:00:00Z' format: date-time type: string example: '2022-01-01T00:00:00Z' - in: query name: createdBefore required: false schema: description: >- Filter results to only include messages created before the specified date and time, in ISO_8601 format. examples: - '2022-01-01T00:00:00Z' format: date-time type: string example: '2022-01-01T00:00:00Z' - in: query name: maxResults required: true schema: description: Maximum number of results to return per page. default: 10 maximum: 100 minimum: 1 type: integer - in: query name: pageToken required: false schema: type: string responses: '200': description: Success content: application/json: schema: type: object required: - data - totalItems - nextPageToken properties: data: type: array items: type: object required: - id - to - from - text - phoneNumberId - conversationId - direction - userId - status - createdAt - updatedAt properties: id: description: The unique identifier of the message. examples: - AC123abc pattern: ^AC(.*)$ type: string example: AC123abc to: type: array items: description: >- A phone number in E.164 format, including the country code. examples: - '+15555555555' pattern: ^\+[1-9]\d{1,14}$ type: string example: '+15555555555' from: description: >- The from identifier, typically a E.164 phone number but can be a variety of formats. examples: - '+15555555555' type: string example: '+15555555555' text: description: The content of the message. examples: - Hello, world! type: string example: Hello, world! phoneNumberId: anyOf: - description: >- The unique identifier of the Quo phone number that the message was sent from. examples: - PN123abc pattern: ^PN(.*)$ type: string example: PN123abc - type: 'null' conversationId: description: The unique identifier of the conversation. examples: - CN123abc pattern: ^CN(.*)$ type: string example: CN123abc direction: type: string enum: - incoming - outgoing description: >- The direction of the message relative to the Quo number. examples: - incoming example: incoming userId: description: >- The unique identifier of the user who sent the message. Null for incoming messages. examples: - US123abc pattern: ^US(.*)$ type: string example: US123abc status: type: string enum: - queued - sent - delivered - undelivered - received description: The status of the message. examples: - sent example: sent createdAt: description: >- The timestamp when the message was created at, in ISO 8601 format examples: - '2022-01-01T00:00:00Z' format: date-time type: string example: '2022-01-01T00:00:00Z' updatedAt: description: >- The timestamp when the message status was last updated, in ISO 8601 format. examples: - '2022-01-01T00:00:00Z' format: date-time type: string example: '2022-01-01T00:00:00Z' totalItems: description: >- Total number of items available. ⚠️ Note: `totalItems` is not accurately returning the total number of items that can be paginated. We are working on fixing this issue. type: integer nextPageToken: anyOf: - type: string - type: 'null' '400': description: A2P Registration Not Approved content: application/json: schema: type: object required: - message - code - status - docs - title - description properties: message: type: string code: const: '0206400' type: string status: const: 400 type: number docs: const: https://quo.com/docs type: string title: const: A2P Registration Not Approved type: string 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 description: const: A2P Registration Not Approved type: string '401': description: Unauthorized content: application/json: schema: type: object required: - message - code - status - docs - title properties: message: type: string code: const: '0200401' type: string status: const: 401 type: number docs: const: https://quo.com/docs type: string title: const: Unauthorized type: string 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 '402': description: Subscription Expired content: application/json: schema: type: object required: - message - code - status - docs - title - description properties: message: type: string code: const: '0201402' type: string status: const: 402 type: number docs: const: https://quo.com/docs type: string title: const: Subscription Expired type: string 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 description: const: Your subscription has expired type: string '403': description: Not Phone Number User content: application/json: schema: type: object required: - message - code - status - docs - title - description properties: message: type: string code: const: '0202403' type: string status: const: 403 type: number docs: const: https://quo.com/docs type: string title: const: Not Phone Number User type: string 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 description: const: Not Phone Number User type: string '404': description: Not Found content: application/json: schema: type: object required: - message - code - status - docs - title properties: message: type: string code: const: '0200404' type: string status: const: 404 type: number docs: const: https://quo.com/docs type: string title: const: Not Found type: string 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 '500': description: Unknown Error content: application/json: schema: type: object required: - message - code - status - docs - title properties: message: type: string code: const: '0201500' type: string status: const: 500 type: number docs: const: https://quo.com/docs type: string title: const: Unknown type: string 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 security: - apiKey: [] components: securitySchemes: apiKey: in: header name: Authorization type: apiKey ````