> ## Documentation Index > Fetch the complete documentation index at: https://docs.connie.ai/llms.txt > Use this file to discover all available pages before exploring further. # List call records > Returns recorded meetings and calls, newest first, with optional filters. Record pages use it with `contact_id`, `company_id` or `deal_id` to show the calls linked to a record. `stats` is included on the first page when no `status` filter is set. ## OpenAPI ````yaml /openapi/inbox.yaml get /calls openapi: 3.1.0 info: title: Connie Inbox API version: 1.0.0 description: > Endpoints the Connie web app uses for the Inbox: conversations, messages, drafts, labels, views, and the Calls and Meetings views. They authenticate with your signed-in browser session — see https://docs.connie.ai/api-reference/authentication. These are the app's own endpoints and can change when the app changes. servers: - url: https://connie.ai/api security: - sessionCookie: [] tags: - name: Conversations description: List, count, pin, star, assign and bulk-update conversations. - name: Messages description: Read messages, read state, reactions, stars, bookmarks and pins. - name: Sending description: >- Send new emails and chats, reply, search recipients and upload attachments. - name: Drafts description: Drafts saved in Connie and drafts stored in a connected mailbox. - name: Labels description: Workspace labels and the labels on each conversation. - name: Views description: Custom Inbox views. - name: Spam description: Mark conversations as spam or not spam. - name: Meetings and calls description: >- Recorded meetings and dialer calls shown in the Inbox, and their action items. paths: /calls: get: tags: - Meetings and calls summary: List call records description: > Returns recorded meetings and calls, newest first, with optional filters. Record pages use it with `contact_id`, `company_id` or `deal_id` to show the calls linked to a record. `stats` is included on the first page when no `status` filter is set. operationId: listMeetings parameters: - $ref: '#/components/parameters/WorkspaceId' - name: status in: query schema: type: string enum: - scheduled - live - processing - ready - partial - failed - name: sentiment in: query schema: type: string enum: - positive - neutral - negative - name: contact_id in: query description: A People record ID. schema: type: string format: uuid - name: company_id in: query description: A Companies record ID. schema: type: string format: uuid - name: deal_id in: query description: A Deals record ID. schema: type: string format: uuid - name: needs_review in: query schema: type: boolean - name: unlinked in: query description: Only calls not linked to a person, company or deal. schema: type: boolean - name: limit in: query schema: type: integer maximum: 200 default: 50 - name: offset in: query schema: type: integer default: 0 responses: '200': description: Call records. content: application/json: schema: type: object properties: calls: type: array items: $ref: '#/components/schemas/Call' stats: type: - object - 'null' additionalProperties: true cursor: type: - integer - 'null' description: The `offset` for the next page, or null on the last page. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' components: parameters: WorkspaceId: name: workspaceId in: query required: true description: > Your workspace ID. Also accepted as `workspace_id`, the `x-workspace-id` header, or `workspaceId` in a JSON body. If you leave it out, the request silently runs against the first workspace you joined. schema: type: string format: uuid schemas: Call: type: object additionalProperties: true properties: id: type: string format: uuid workspace_id: type: string format: uuid call_status: type: - string - 'null' enum: - scheduled - joining - waiting_room - live - processing - ready - partial - failed - cancelled - consent_declined - kicked - missed - null analysis_status: type: - string - 'null' enum: - complete - partial - failed - blocked - null meeting_platform: type: - string - 'null' enum: - zoom - teams - meet - slack - other - null call_date: type: - string - 'null' format: date-time duration_seconds: type: - integer - 'null' summary: type: - string - 'null' sentiment: type: - string - 'null' enum: - positive - neutral - negative - null topics: type: - array - 'null' items: type: string participants: type: - array - 'null' items: type: object properties: name: type: string email: type: - string - 'null' company: type: - string - 'null' talk_ratio_pct: type: - number - 'null' is_internal: type: boolean attended: type: boolean contact_id: type: - string - 'null' company_id: type: - string - 'null' deal_id: type: - string - 'null' created_at: type: string format: date-time updated_at: type: string format: date-time Error: type: object properties: error: type: string code: type: string responses: BadRequest: description: Missing or invalid input. content: application/json: schema: $ref: '#/components/schemas/Error' Unauthorized: description: No valid session, or the session expired (`SESSION_EXPIRED`). content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: sessionCookie: type: apiKey in: header name: Cookie description: >- The full Cookie header copied from a signed-in connie.ai browser request. See the Authentication page. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.