El acceso de lectura a las auditorías depende del rol de tu API key. 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.
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 devuelve la API. Devuelve 404 cuando la sesión no tiene auditoría: la auditoría está deshabilitada para esa sesión o aún no se ha ejecutado.
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 API key institucional; con 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.
total y totalPages son siempre null: el servidor no cuenta los elementos de la lista. Usa hasMore para paginar. Cada elemento omite el desglose por secciones; obtén la auditoría completa desde el endpoint de la sesión descrito arriba.Configuraciones de auditoría
GET /v1/audits/configurations devuelve las rúbricas asignadas a tu institución, es decir, las que se usan para auditarla. Requiere una API key institucional. Cada rúbrica lista sus sections ponderadas y sus scoreBands de calificación, para que puedas convertir un score en una etiqueta.
A un puntaje le corresponde la primera banda cuyo
threshold sea igual o menor que él (las bandas están ordenadas por threshold de forma descendente). label y displayName pueden ser null cuando la rúbrica no tiene texto en el idioma predeterminado.