> ## Documentation Index > Fetch the complete documentation index at: https://docs.telli.com/llms.txt > Use this file to discover all available pages before exploring further. # Anrufe auflisten > Returns a paginated list of calls for the authenticated account, ordered by `triggered_at` descending. Optionally filter by `contact_id` to return only calls for a single contact, or by `agent_id` to return only calls for a single agent. `contact_id` and `agent_id` cannot be used together. Each item is a lean call payload: the response does not include a separate top-level `contact` object, and the `external_contact_id` and `contact_details` fields are omitted from each call (unlike [Get Call](/v1/endpoint/get-call)). Use the Contact endpoints if you need contact details. ## Zuordnung der Anrufstatus Verwende `call_status` nicht für neue Integrationen. Das Feld ist veraltet und wird nur aus Gründen der Abwärtskompatibilität zurückgegeben. Verwende stattdessen `state`, `status` und `follow_up`. | `call_status` | `state` | `status` | `follow_up` | | ---------------- | ------------- | --------------- | ---------------- | | `INITIATED` | `queued` | `null` | `null` | | `RINGING` | `ringing` | `null` | `null` | | `IN_PROGRESS` | `in_progress` | `null` | `null` | | Nicht zutreffend | `processing` | `null` | Nicht zutreffend | | `COMPLETED` | `ended` | `connected` | `null` | | `ANSWERED` | `ended` | `connected` | gesetzt | | `NOT_REACHED` | `ended` | `not_connected` | `null` | | `VOICEMAIL` | `ended` | `voicemail` | `null` | | `ERROR` | `ended` | `failed` | `null` | ## OpenAPI ````yaml openapi.json GET /v1/list-calls openapi: 3.0.3 info: title: telli API version: 1.0.0 description: API documentation for telli's V1 endpoints servers: - url: https://api.telli.com security: - apiKey: [] paths: /v1/list-calls: get: summary: List Calls description: >- Returns a paginated list of calls for the authenticated account, ordered by `triggered_at` descending. Optionally filter by `contact_id` to return only calls for a single contact, or by `agent_id` to return only calls for a single agent. `contact_id` and `agent_id` cannot be used together. Each item is a lean call payload: the response does not include a separate top-level `contact` object, and the `external_contact_id` and `contact_details` fields are omitted from each call (unlike [Get Call](/v1/endpoint/get-call)). Use the Contact endpoints if you need contact details. parameters: - name: contact_id in: query required: false schema: type: string format: uuid description: Only return calls for this telli contact ID - name: agent_id in: query required: false schema: type: string format: uuid description: >- Only return calls for this telli agent ID. Cannot be combined with `contact_id`. - name: limit in: query required: false schema: type: integer minimum: 1 maximum: 100 default: 50 description: Maximum number of calls to return (1-100, default 50) - name: cursor in: query required: false schema: type: string description: >- Opaque cursor returned as `next_cursor` from a previous response. Pass unchanged to fetch the next page. responses: '200': description: Calls retrieved successfully content: application/json: schema: type: object properties: calls: type: array description: Calls ordered by `triggered_at` descending items: type: object properties: call_id: type: string format: uuid description: Unique identifier for the call attempt: type: number description: Which attempt number this call is within its loop from_number: type: string description: Caller phone number in E.164 format to_number: type: string description: Callee phone number in E.164 format direction: type: string description: 'Call direction: ''inbound'' or ''outbound''' contact_id: type: string format: uuid description: telli contact ID agent_id: type: string format: uuid description: ID of the agent that handled the call triggered_at: type: number description: Unix timestamp (ms) when the call was triggered triggered_at_iso: type: string description: ISO 8601 timestamp when the call was triggered started_at: type: number description: Unix timestamp (ms) when the call was answered started_at_iso: type: string description: ISO 8601 timestamp when the call was answered ended_at: type: number description: Unix timestamp (ms) when the call ended ended_at_iso: type: string description: ISO 8601 timestamp when the call ended call_length_min: type: number description: Duration of the call in minutes (rounded up) call_status: type: string description: >- Deprecated. Use state, status, and follow_up instead. deprecated: true enum: - COMPLETED - ANSWERED - NOT_REACHED - VOICEMAIL - ERROR transcript: type: string description: Plain text transcript of the call transcriptObject: type: array description: Structured transcript as an array of messages items: oneOf: - type: object required: - role - content properties: role: type: string enum: - user - agent content: type: string - type: object required: - role - toolActivity properties: role: type: string enum: - agent toolActivity: type: string toolParameters: type: object additionalProperties: type: string call_analysis: type: object description: AI-generated analysis of the call additionalProperties: type: object properties: value: type: boolean details: type: string call_outcome: type: object description: Structured outcome data extracted from the call additionalProperties: type: object properties: value: {} reason: type: string fieldSchema: type: object error: type: string collected_data: type: object description: >- Data collected from the contact during the call via tasks additionalProperties: type: object properties: status: type: string enum: - in_progress - confirmed - declined - error value: type: string booked_slot_for: type: string description: >- ISO 8601 timestamp of the booked appointment slot, if any recording_url: type: string description: >- URL to the call recording (only available when both parties have given consent) ended_reason: type: string description: Why the call ended enum: - agent-ended-call - agent-forwarded-call - agent-busy - agent-did-not-answer - contact-busy - contact-ended-call - contact-did-not-answer - phone-provider-closed-connection - other state: type: string description: Current call lifecycle state enum: - queued - ringing - in_progress - processing - ended status: type: string nullable: true description: >- Normalized terminal connection status. Null while the call is not terminal. enum: - connected - not_connected - voicemail - failed follow_up: type: object nullable: true description: >- Scheduled follow-up call information, if the agent scheduled one. required: - type - scheduled_at properties: type: type: string enum: - agent_follow_up scheduled_at: type: string format: date-time description: When the follow-up call is scheduled next_cursor: type: string nullable: true description: >- Pass as `cursor` in the next request to fetch more results. `null` when there are no more pages. '400': description: >- Invalid request - malformed UUID, invalid cursor, or `contact_id` and `agent_id` used together content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Unauthorized - Invalid API key content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: Error: type: object properties: message: type: string securitySchemes: apiKey: type: apiKey in: header name: Authorization description: 'API key must be provided as: Bearer ' x-bearer-format: Bearer ````