> ## 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 respuestas

> Obtiene las respuestas enviadas por pacientes para un formulario específico.

## Path Parameters

<ParamField path="id" type="string" required>
  ID del formulario (ej. `form_abc123`).
</ParamField>

## Query Parameters

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

<ParamField query="startDate" type="string">
  Fecha inicio en formato ISO 8601 (ej. `2026-05-01T00:00:00Z`).
</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": "resp_aaa111",
        "formId": "form_abc123",
        "patientId": "pat_xyz789",
        "scheduleId": "sch_def456",
        "responses": [
          { "fieldId": "pain_level", "value": 3 },
          { "fieldId": "pain_location", "value": "Espalda" },
          { "fieldId": "pain_duration", "value": "1-6 horas" },
          { "fieldId": "medication_taken", "value": true },
          { "fieldId": "notes", "value": "Mejorando respecto a ayer" }
        ],
        "completedAt": "2026-05-14T09:15:00Z"
      },
      {
        "id": "resp_bbb222",
        "formId": "form_abc123",
        "patientId": "pat_abc123",
        "scheduleId": "sch_ghi789",
        "responses": [
          { "fieldId": "pain_level", "value": 7 },
          { "fieldId": "pain_location", "value": "Abdomen" },
          { "fieldId": "pain_duration", "value": "Más de 24 horas" },
          { "fieldId": "medication_taken", "value": false },
          { "fieldId": "notes", "value": "" }
        ],
        "completedAt": "2026-05-14T10:30:00Z"
      }
    ],
    "pagination": {
      "cursor": "eyJpZCI6InJlc3BfYmJiMjIyIn0=",
      "hasMore": false,
      "limit": 20
    }
  }
  ```
</ResponseExample>

<ResponseField name="data[].responses" type="array">
  Array con las respuestas del paciente, cada una con `fieldId` y `value`.
</ResponseField>

<ResponseField name="data[].completedAt" type="string">
  Fecha y hora en que el paciente completó el formulario.
</ResponseField>

<ResponseField name="data[].scheduleId" type="string">
  ID de la programación que originó este envío, si aplica.
</ResponseField>


## OpenAPI

````yaml openapi.yml GET /clinical-forms/{id}/responses
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:
  /clinical-forms/{id}/responses:
    get:
      tags:
        - Formularios Clínicos
      summary: Listar respuestas de un formulario
      operationId: listFormResponses
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Respuestas
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Token JWT obtenido via POST /auth/token

````