> ## Documentation Index > Fetch the complete documentation index at: https://docs.lumisreach.com/llms.txt > Use this file to discover all available pages before exploring further. # List calls > The workspace's calls, most recent first: inbound and outbound, AI and human, on both LumisReach voice stacks, including Quick AI Phone Calls. Each has its full transcript (plain text and speaker-labelled turns), AI summary, tags, status and duration, plus a `recording_url` to download the audio. Narrow it to one person with `contact_id` or `phone_number`, and filter by `direction`, `status` or a `created_after` / `created_before` window. Free: reads are never billed. ## OpenAPI ````yaml /openapi.json get /v1/calls openapi: 3.1.0 info: title: LumisReach v1 API version: 1.0.0 description: >- Programmatic access to the LumisReach voice platform — calls, numbers, caller trust, and brands. contact: name: LumisReach email: founders@lumisreach.com servers: - url: https://api.lumisreach.com/api security: - bearerAuth: [] tags: - name: Contacts - name: Calls - name: Messages - name: Emails - name: Phone Numbers - name: Caller IDs - name: Enterprise Registration - name: Branded Calling - name: Dialer Calls - name: SMS - name: WebRTC - name: Reputation - name: Usage - name: Account - name: Billing - name: Documents - name: Lincoln AI - name: Quick Agent Actions - name: Sub-entities - name: Video schedules - name: Videos paths: /v1/calls: get: tags: - Calls summary: List calls description: >- The workspace's calls, most recent first: inbound and outbound, AI and human, on both LumisReach voice stacks, including Quick AI Phone Calls. Each has its full transcript (plain text and speaker-labelled turns), AI summary, tags, status and duration, plus a `recording_url` to download the audio. Narrow it to one person with `contact_id` or `phone_number`, and filter by `direction`, `status` or a `created_after` / `created_before` window. Free: reads are never billed. operationId: v1_calls_get parameters: - name: contact_id in: query required: false schema: description: >- A contact id (from `GET /v1/contacts`). Its phone number / email is used. type: string minLength: 1 - name: phone_number in: query required: false schema: description: The person's phone number, E.164 (+14155550123) type: string minLength: 3 - name: direction in: query required: false schema: description: Only `inbound` (they reached you) or `outbound` (you reached them) type: string enum: - inbound - outbound - name: status in: query required: false schema: description: >- Only calls in this status: `completed`, `voicemail`, `failed`, `busy`, `canceled`, `in_progress`, `ringing` or `queued` type: string enum: - QUEUED - RINGING - IN_PROGRESS - COMPLETED - FAILED - BUSY - VOICEMAIL - CANCELED - name: created_after in: query required: false schema: description: Only items created at or after this time (ISO 8601) - name: created_before in: query required: false schema: description: Only items created before this time (ISO 8601) - name: limit in: query required: true schema: default: 20 type: integer minimum: 1 maximum: 50 - name: cursor in: query required: false schema: description: '`meta.cursor` from the previous page' type: string responses: '200': description: Success content: application/json: schema: $schema: http://json-schema.org/draft-07/schema# type: object properties: data: type: array items: type: object properties: id: type: string direction: anyOf: - type: string enum: - inbound - outbound - type: 'null' status: type: string from_number: type: string to_number: type: string started_at: type: - string - 'null' ended_at: type: - string - 'null' duration_seconds: type: - number - 'null' summary: type: - string - 'null' transcript: type: - string - 'null' transcript_turns: type: array items: type: object properties: speaker: type: string enum: - agent - person text: type: string seconds_from_start: type: - number - 'null' required: - speaker - text - seconds_from_start additionalProperties: false tags: type: array items: type: string enum: - booking_requested - callback_requested - complaint - purchase_interest - interested - qualified - not_interested - transferred has_recording: type: boolean recording_url: description: >- `GET` it with your API key to download the audio (`GET /v1/calls/{id}/recording`). Null when the call has no recording. type: - string - 'null' created_at: type: string required: - id - direction - status - from_number - to_number - started_at - ended_at - duration_seconds - summary - transcript - transcript_turns - tags - has_recording - recording_url - created_at additionalProperties: false meta: type: object properties: cursor: type: string page_size: type: number required: - page_size additionalProperties: false required: - data - meta additionalProperties: false '400': description: Validation error content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '404': description: Not found content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '409': description: Conflict (incl. idempotency conflicts) content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '429': description: Rate limited content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' components: schemas: ErrorEnvelope: type: object properties: error: type: object required: - code - message properties: code: type: string message: type: string fields: type: object additionalProperties: type: string doc_url: type: string format: uri securitySchemes: bearerAuth: type: http scheme: bearer ````