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