> ## Documentation Index > Fetch the complete documentation index at: https://developers.cconnect.online/llms.txt > Use this file to discover all available pages before exploring further. # List conversations > Returns company-owned conversations without embedding message history. Filters: status, updated_since. Required scope: `conversations:read`. Required product: `chat`. ## OpenAPI ````yaml /openapi.json get /api/v1/conversations openapi: 3.0.1 info: title: Cconnect Customer API description: >- Company-scoped REST API for Cconnect Desk and Chat. Bearer credentials are issued by your company administrator. Public documentation does not grant data access. Operations require CustomerApi:Enabled on the API deployment. contact: name: Cconnect url: https://cconnect.online version: 1.0.0 servers: - url: https://cconnect.online description: Cconnect API server (separate from developers.cconnect.online) security: - CustomerBearer: [] externalDocs: description: Cconnect developer portal url: https://developers.cconnect.online paths: /api/v1/conversations: get: tags: - Conversations summary: List conversations description: >- Returns company-owned conversations without embedding message history. Filters: status, updated_since. Required scope: `conversations:read`. Required product: `chat`. operationId: ListConversations parameters: - name: page in: query description: Page number (1–1000). schema: maximum: 1000 minimum: 1 type: integer default: 1 - name: per_page in: query description: Results per page (1–100). schema: maximum: 100 minimum: 1 type: integer default: 25 - name: status in: query schema: enum: - open - resolved type: string - name: updated_since in: query description: >- Inclusive lower bound, ISO 8601 timestamp with timezone. Pages are live; changes during pagination may shift results. Deduplicate IDs and overlap sync windows. schema: type: string format: date-time example: '2026-10-01T00:00:00Z' responses: '200': description: OK headers: X-Request-Id: description: Support correlation ID. schema: type: string X-RateLimit-Limit: description: >- Company quota metadata (reset is Unix seconds). Present after bearer authentication and company subscription validation. schema: type: integer format: int64 X-RateLimit-Remaining: description: >- Company quota metadata (reset is Unix seconds). Present after bearer authentication and company subscription validation. schema: type: integer format: int64 X-RateLimit-Reset: description: >- Company quota metadata (reset is Unix seconds). Present after bearer authentication and company subscription validation. schema: type: integer format: int64 content: application/json: schema: $ref: '#/components/schemas/ApiConversationApiList' '400': description: Bad Request headers: X-Request-Id: description: Support correlation ID. schema: type: string X-RateLimit-Limit: description: >- Company quota metadata (reset is Unix seconds). Present after bearer authentication and company subscription validation. schema: type: integer format: int64 X-RateLimit-Remaining: description: >- Company quota metadata (reset is Unix seconds). Present after bearer authentication and company subscription validation. schema: type: integer format: int64 X-RateLimit-Reset: description: >- Company quota metadata (reset is Unix seconds). Present after bearer authentication and company subscription validation. schema: type: integer format: int64 content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '401': description: Unauthorized headers: X-Request-Id: description: Support correlation ID. schema: type: string X-RateLimit-Limit: description: >- Company quota metadata (reset is Unix seconds). Present after bearer authentication and company subscription validation. schema: type: integer format: int64 X-RateLimit-Remaining: description: >- Company quota metadata (reset is Unix seconds). Present after bearer authentication and company subscription validation. schema: type: integer format: int64 X-RateLimit-Reset: description: >- Company quota metadata (reset is Unix seconds). Present after bearer authentication and company subscription validation. schema: type: integer format: int64 content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '403': description: Forbidden headers: X-Request-Id: description: Support correlation ID. schema: type: string X-RateLimit-Limit: description: >- Company quota metadata (reset is Unix seconds). Present after bearer authentication and company subscription validation. schema: type: integer format: int64 X-RateLimit-Remaining: description: >- Company quota metadata (reset is Unix seconds). Present after bearer authentication and company subscription validation. schema: type: integer format: int64 X-RateLimit-Reset: description: >- Company quota metadata (reset is Unix seconds). Present after bearer authentication and company subscription validation. schema: type: integer format: int64 content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '404': description: Not Found headers: X-Request-Id: description: Support correlation ID. schema: type: string X-RateLimit-Limit: description: >- Company quota metadata (reset is Unix seconds). Present after bearer authentication and company subscription validation. schema: type: integer format: int64 X-RateLimit-Remaining: description: >- Company quota metadata (reset is Unix seconds). Present after bearer authentication and company subscription validation. schema: type: integer format: int64 X-RateLimit-Reset: description: >- Company quota metadata (reset is Unix seconds). Present after bearer authentication and company subscription validation. schema: type: integer format: int64 content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '413': description: Content Too Large headers: X-Request-Id: description: Support correlation ID. schema: type: string X-RateLimit-Limit: description: >- Company quota metadata (reset is Unix seconds). Present after bearer authentication and company subscription validation. schema: type: integer format: int64 X-RateLimit-Remaining: description: >- Company quota metadata (reset is Unix seconds). Present after bearer authentication and company subscription validation. schema: type: integer format: int64 X-RateLimit-Reset: description: >- Company quota metadata (reset is Unix seconds). Present after bearer authentication and company subscription validation. schema: type: integer format: int64 content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '415': description: Unsupported Media Type headers: X-Request-Id: description: Support correlation ID. schema: type: string X-RateLimit-Limit: description: >- Company quota metadata (reset is Unix seconds). Present after bearer authentication and company subscription validation. schema: type: integer format: int64 X-RateLimit-Remaining: description: >- Company quota metadata (reset is Unix seconds). Present after bearer authentication and company subscription validation. schema: type: integer format: int64 X-RateLimit-Reset: description: >- Company quota metadata (reset is Unix seconds). Present after bearer authentication and company subscription validation. schema: type: integer format: int64 content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '429': description: Too Many Requests headers: X-Request-Id: description: Support correlation ID. schema: type: string Retry-After: description: Seconds until a retry is allowed. schema: type: integer X-RateLimit-Limit: description: >- Company quota metadata (reset is Unix seconds). Present after bearer authentication and company subscription validation. schema: type: integer format: int64 X-RateLimit-Remaining: description: >- Company quota metadata (reset is Unix seconds). Present after bearer authentication and company subscription validation. schema: type: integer format: int64 X-RateLimit-Reset: description: >- Company quota metadata (reset is Unix seconds). Present after bearer authentication and company subscription validation. schema: type: integer format: int64 content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '500': description: Internal Server Error headers: X-Request-Id: description: Support correlation ID. schema: type: string X-RateLimit-Limit: description: >- Company quota metadata (reset is Unix seconds). Present after bearer authentication and company subscription validation. schema: type: integer format: int64 X-RateLimit-Remaining: description: >- Company quota metadata (reset is Unix seconds). Present after bearer authentication and company subscription validation. schema: type: integer format: int64 X-RateLimit-Reset: description: >- Company quota metadata (reset is Unix seconds). Present after bearer authentication and company subscription validation. schema: type: integer format: int64 content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '503': description: Service Unavailable headers: X-Request-Id: description: Support correlation ID. schema: type: string X-RateLimit-Limit: description: >- Company quota metadata (reset is Unix seconds). Present after bearer authentication and company subscription validation. schema: type: integer format: int64 X-RateLimit-Remaining: description: >- Company quota metadata (reset is Unix seconds). Present after bearer authentication and company subscription validation. schema: type: integer format: int64 X-RateLimit-Reset: description: >- Company quota metadata (reset is Unix seconds). Present after bearer authentication and company subscription validation. schema: type: integer format: int64 content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' components: schemas: ApiConversationApiList: type: object properties: data: type: array items: $ref: '#/components/schemas/ApiConversation' meta: $ref: '#/components/schemas/ApiPagination' additionalProperties: false ApiErrorResponse: type: object properties: error: $ref: '#/components/schemas/ApiError' request_id: type: string additionalProperties: false ApiConversation: type: object properties: id: type: string title: type: string channel: type: string kind: type: string status: type: string channel_id: type: string updated_at: type: string format: date-time additionalProperties: false ApiPagination: type: object properties: page: type: integer format: int32 per_page: type: integer format: int32 has_more: type: boolean additionalProperties: false ApiError: type: object properties: code: type: string message: type: string field: type: string nullable: true additionalProperties: false securitySchemes: CustomerBearer: type: http description: >- Company-owned API token. Supply Authorization: Bearer YOUR_CCONNECT_API_TOKEN. Never use provider tokens or member passwords. Tokens are shown only once when created. scheme: bearer bearerFormat: Cconnect API token ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.