> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linahealthcareplatform.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar llamadas

> Obtiene una lista paginada de llamadas realizadas.

## Query Parameters

<ParamField query="patientId" type="string">
  Filtra por paciente.
</ParamField>

<ParamField query="status" type="string">
  Filtra por estado. Valores: `queued`, `ringing`, `in-progress`, `completed`, `failed`.
</ParamField>

<ParamField query="startDate" type="string">
  Fecha inicio en formato ISO 8601.
</ParamField>

<ParamField query="endDate" type="string">
  Fecha fin en formato ISO 8601.
</ParamField>

<ParamField query="limit" type="integer" default="20">
  Número de resultados por página (máximo 100).
</ParamField>

<ParamField query="cursor" type="string">
  Cursor de paginación.
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "id": "call_abc123",
        "patientId": "pat_xyz789",
        "status": "completed",
        "purpose": "Seguimiento post-operatorio día 3",
        "language": "es",
        "duration": 187,
        "creditsConsumed": 55,
        "createdAt": "2026-05-14T10:30:00Z",
        "completedAt": "2026-05-14T10:33:07Z"
      },
      {
        "id": "call_def456",
        "patientId": "pat_abc123",
        "status": "failed",
        "purpose": "Recordatorio de medicación",
        "language": "es",
        "duration": 0,
        "creditsConsumed": 5,
        "failureReason": "no_answer",
        "createdAt": "2026-05-14T11:00:00Z"
      }
    ],
    "pagination": {
      "cursor": "eyJpZCI6ImNhbGxfZGVmNDU2In0=",
      "hasMore": true,
      "limit": 20
    }
  }
  ```
</ResponseExample>

<ResponseField name="data" type="array">
  Lista de llamadas. No incluye transcripción ni resumen — usa [obtener estado](/api-reference/calls/status) para ver los detalles completos.
</ResponseField>


## OpenAPI

````yaml openapi.yml GET /voice/calls
openapi: 3.1.0
info:
  title: LINA Healthcare Platform API
  version: 1.0.0
  description: |
    API de integración para la plataforma LINA Healthcare.
    Todas las rutas requieren un token JWT obtenido intercambiando una API Key.
servers:
  - url: https://api.linahealthcareplatform.com/api/v1
    description: Production
security:
  - bearerAuth: []
paths:
  /voice/calls:
    get:
      tags:
        - Llamadas
      summary: Listar llamadas
      operationId: listCalls
      parameters:
        - name: limit
          in: query
          schema:
            type: integer
        - name: cursor
          in: query
          schema:
            type: string
      responses:
        '200':
          description: Llamadas
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/VoiceCall'
components:
  schemas:
    VoiceCall:
      type: object
      properties:
        id:
          type: string
        patientId:
          type: string
        status:
          type: string
          enum:
            - queued
            - ringing
            - in-progress
            - completed
            - failed
        duration:
          type: integer
        transcript:
          type: string
        summary:
          type: string
        createdAt:
          type: string
          format: date-time
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Token JWT obtenido via POST /auth/token

````