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

# Auditorías

> Consulta la auditoría de calidad de una sesión, lista las auditorías de una institución y consulta las rúbricas

Una auditoría califica el registro médico de una sesión de scribe finalizada contra una rúbrica (una configuración de auditoría). Devuelve un total ponderado en una escala de 0..1, una calificación cualitativa y un desglose por secciones.

<Note>
  Las lecturas de auditoría siguen el rol de tu clave API. La auditoría de una sesión está disponible para una clave de médico (sus propias sesiones) y para una clave institucional. La **lista** de auditorías y las **configuraciones** requieren una clave institucional.
</Note>

## Consultar la auditoría de una sesión

`GET /v1/scribe-sessions/{id}/audit` devuelve la auditoría de una sesión. El `{id}` es el `consultationInternalId` que definiste, o el id de la sesión (`ss_...`) que la API devuelve. Devuelve `404` cuando la sesión no tiene auditoría — la auditoría está deshabilitada, o aún no se ha ejecutado.

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

**Respuesta:**

```json theme={null}
{
  "id": "au_a1b2c3d4e5f6g7h8",
  "score": 0.82,
  "grade": "ACEPTABLE",
  "reviewStatus": "reviewed",
  "origin": "scribe",
  "createdAt": "2026-02-20T10:35:00Z",
  "configuration": {
    "id": "ac_9f8e7d6c5b4a3210",
    "name": "General medicine v2",
    "version": "1.2"
  },
  "sections": [
    { "name": "ANAMNESIS", "label": "Anamnesis", "score": 0.9 }
  ]
}
```

<Tip>
  `score` es el total ponderado en una escala de 0..1. Conviértelo en una banda de calificación con los `scoreBands` de la rúbrica, descritos en la sección de configuraciones de auditoría más abajo.
</Tip>

## Listar auditorías

`GET /v1/audits` lista las auditorías de tu institución, de la más reciente a la más antigua. Requiere una clave API institucional; una clave de médico devuelve `403`. Pagina con `page` (base 1) y `limit` (1–50, por defecto 20). Filtra con `reviewStatus`, `createdFrom` y `createdTo`.

```bash theme={null}
curl "https://scribe-api.telepatia.ai/v1/audits?page=1&limit=20&reviewStatus=reviewed" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

**Respuesta:**

```json theme={null}
{
  "items": [
    {
      "id": "au_a1b2c3d4e5f6g7h8",
      "score": 0.82,
      "grade": "ACEPTABLE",
      "reviewStatus": "reviewed",
      "origin": "scribe",
      "createdAt": "2026-02-20T10:35:00Z",
      "patientName": "John Doe",
      "configuration": {
        "id": "ac_9f8e7d6c5b4a3210",
        "name": "General medicine v2",
        "version": "1.2"
      }
    }
  ],
  "total": null,
  "page": 1,
  "limit": 20,
  "totalPages": null,
  "hasMore": false
}
```

<Note>
  `total` y `totalPages` son siempre `null` — la lista no se cuenta en el servidor. Usa `hasMore` para paginar. Cada elemento omite el desglose por secciones; obtén la auditoría completa desde el endpoint de la sesión de arriba.
</Note>

## Configuraciones de auditoría

`GET /v1/audits/configurations` devuelve las rúbricas asignadas a tu institución — las que se usan para auditarla. Requiere una clave API institucional. Cada rúbrica lista sus `sections` ponderadas y sus `scoreBands` de calificación, para que puedas convertir un `score` en una etiqueta.

```bash theme={null}
curl https://scribe-api.telepatia.ai/v1/audits/configurations \
  -H "Authorization: Bearer YOUR_API_KEY"
```

**Respuesta:**

```json theme={null}
{
  "items": [
    {
      "id": "ac_9f8e7d6c5b4a3210",
      "name": "General medicine v2",
      "version": "1.2",
      "active": true,
      "sections": [
        { "name": "ANAMNESIS", "displayName": "Anamnesis", "weight": 0.2 }
      ],
      "scoreBands": [
        { "threshold": 0.9, "label": "SOBRESALIENTE", "tone": "success" },
        { "threshold": 0.8, "label": "ACEPTABLE", "tone": "info" },
        { "threshold": 0.0, "label": "DEFICIENTE", "tone": "destructive" }
      ]
    }
  ]
}
```

<Note>
  Una puntuación obtiene la primera banda cuyo `threshold` es igual o menor que ella (las bandas se ordenan por `threshold`, de forma descendente). `label` y `displayName` pueden ser `null` cuando la rúbrica no lleva texto en el idioma por defecto.
</Note>