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

# Sesiones de Scribe

> Recuperar el estado y los metadatos de una sesión de scribe

Una sesión de scribe se crea cuando un médico realiza una consulta a través de la interfaz de Telepatia. Una vez finalizada, aquí puede consultar su ciclo de vida y los metadatos de la consulta, y luego obtener el registro completo desde el endpoint de [Documentos de Registro Médico](/es/scribe-api/medical-record-documents).

## Ciclo de vida de la sesión

Una sesión pasa por varios estados. Los valores siguientes se devuelven tal cual en el campo `status`.

| Estado                | Fase      | Descripción                                                                             |
| --------------------- | --------- | --------------------------------------------------------------------------------------- |
| `created`             | en curso  | Sesión abierta, la grabación aún no comenzó                                             |
| `recording`           | en curso  | El médico está grabando activamente la consulta                                         |
| `stopped`             | en curso  | Grabación terminada; el audio se está subiendo y poniendo en cola para el procesamiento |
| `processing`          | en curso  | Pipeline de IA (transcripción + generación del registro) en ejecución                   |
| `completed`           | **listo** | Pipeline finalizado — los documentos están disponibles                                  |
| `completedWithErrors` | **listo** | Pipeline finalizado con errores no fatales — los documentos siguen disponibles          |
| `reviewed`            | **listo** | El médico revisó y finalizó el registro                                                 |
| `error`               | terminal  | Error fatal durante el procesamiento — no se producirán documentos                      |
| `cancelled`           | terminal  | El usuario canceló la sesión                                                            |
| `unknown`             | —         | Valor por defecto cuando el estado upstream no es reconocido                            |

## Recuperar una sesión

Use el `consultationInternalId` que proporcionó (o recibió) al configurar el contexto de consulta:

```bash theme={null}
curl https://scribe-api.telepatia.ai/v1/scribe-sessions/CONSULT-12345 \
  -H "Authorization: Bearer SU_CLAVE_API"
```

**Respuesta:**

```json theme={null}
{
  "id": "ss_a1b2c3d4e5f6g7h8",
  "status": "completed",
  "createdAt": "2026-02-20T10:00:00Z",
  "completedAt": "2026-02-20T10:30:00Z",
  "patientName": "John Doe",
  "scribeSessionModality": "IN_PERSON",
  "consultationInternalId": "CONSULT-12345",
  "specialty": "Cardiology"
}
```

Este endpoint devuelve solo metadatos de ciclo de vida y de la consulta. El registro completo — y sus códigos de diagnóstico ICD — se obtiene del endpoint de [Documentos de Registro Médico](/es/scribe-api/medical-record-documents).

<Tip>
  Mientras `status` siga en curso (`created`, `recording`, `stopped`, `processing`), consulte este endpoint hasta que llegue a un estado listo (`completed`, `completedWithErrors`, `reviewed`) antes de obtener el registro completo. `error` y `cancelled` son estados terminales — no se producirán documentos.
</Tip>

## Recuperar el registro completo

Este endpoint solo devuelve el ciclo de vida y los metadatos de la consulta. El registro completo —la salida de las plantillas de sesión, con todas las secciones— se obtiene por separado desde el endpoint de documentos de registro médico, usando el mismo `consultationInternalId`:

```bash theme={null}
curl https://scribe-api.telepatia.ai/v1/scribe-sessions/CONSULT-12345/medical-record-documents \
  -H "Authorization: Bearer SU_CLAVE_API"
```

Una sesión puede producir más de un documento (uno por `purpose` — p.ej. `primary` para el registro del médico, `rpa` para inyección en el EMR). Filtre con `?purpose=primary` para obtener solo el principal. Vea [Documentos de Registro Médico](/es/scribe-api/medical-record-documents) para la forma completa de la respuesta y la referencia de campos.