> ## 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. # Listar auditorías > Lista las auditorías de la institución, paginadas. Requiere una clave institucional. ## OpenAPI ````yaml /es/scribe-api/openapi-institutional.json get /v1/audits openapi: 3.1.0 info: title: Scribe Public API description: >- API REST externa para integración con la plataforma Telepatia. Autentíquese con claves API, establezca el contexto de consulta y consulte sesiones de scribe. version: 0.1.0 servers: - url: https://scribe-api.telepatia.ai description: Production security: - BearerAuth: [] paths: /v1/audits: get: tags: - Audits summary: Listar auditorías description: >- Lista las auditorías de la institución, paginadas. Requiere una clave institucional. operationId: api_audit_list_v1_audits_get parameters: - name: page in: query required: false schema: type: integer minimum: 1 description: Page number (1-based). default: 1 title: Page description: Page number (1-based). - name: limit in: query required: false schema: type: integer maximum: 50 minimum: 1 description: Number of items per page. default: 20 title: Limit description: Number of items per page. - name: reviewStatus in: query required: false schema: anyOf: - $ref: '#/components/schemas/AuditReviewStatus' - type: 'null' description: >- Filter by human-review state: 'pending', 'inReview', or 'reviewed'. title: Reviewstatus description: 'Filter by human-review state: ''pending'', ''inReview'', or ''reviewed''.' example: pending - name: createdFrom in: query required: false schema: anyOf: - type: string format: date-time - type: 'null' description: Only audits created at or after this time (ISO-8601). title: Createdfrom description: Only audits created at or after this time (ISO-8601). - name: createdTo in: query required: false schema: anyOf: - type: string format: date-time - type: 'null' description: Only audits created at or before this time (ISO-8601). title: Createdto description: Only audits created at or before this time (ISO-8601). responses: '200': description: Respuesta exitosa content: application/json: schema: $ref: '#/components/schemas/AuditListResponse' example: hasMore: false items: - configuration: id: ac_9f8e7d6c5b4a3210 name: General medicine v2 version: '1.2' createdAt: '2026-02-20T10:35:00Z' grade: ACEPTABLE id: au_a1b2c3d4e5f6g7h8 origin: scribe patientName: John Doe reviewStatus: reviewed score: 0.82 limit: 20 page: 1 '400': description: >- Solicitud incorrecta — parámetros inválidos, fallos de validación o campos faltantes. content: application/json: examples: parameter_missing: summary: Missing required field value: error: type: invalid_request_error code: parameter_missing message: name is required. param: name requestId: 3f9a1c2e-5b7d-4a21-9f0c-8e6d4b2a1c30 parameter_invalid: summary: Invalid field value value: error: type: invalid_request_error code: parameter_invalid message: >- idCountry must be a valid country name, ISO alpha-2, or ISO alpha-3 code. param: idCountry requestId: 3f9a1c2e-5b7d-4a21-9f0c-8e6d4b2a1c30 account_invalid: summary: Invalid account value: error: type: invalid_request_error code: account_invalid message: Account has no valid authId. requestId: 3f9a1c2e-5b7d-4a21-9f0c-8e6d4b2a1c30 schema: $ref: '#/components/schemas/ErrorResponse' '401': description: No autorizado — clave API faltante o inválida. content: application/json: examples: authentication_required: summary: Invalid or missing API key value: error: type: authentication_error code: authentication_required message: Invalid API key. requestId: 3f9a1c2e-5b7d-4a21-9f0c-8e6d4b2a1c30 schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Prohibido — la clave API no puede realizar esta operación. content: application/json: examples: permission_denied: summary: Caller lacks permission for this resource value: error: type: permission_error code: permission_denied message: You do not have permission to access this resource. requestId: 3f9a1c2e-5b7d-4a21-9f0c-8e6d4b2a1c30 permission_denied_role: summary: API key's account role is not allowed this operation value: error: type: permission_error code: permission_denied message: >- Your API key is not allowed to create accounts. Account creation requires an institutional API key; this key is scoped to a doctor account. requestId: 3f9a1c2e-5b7d-4a21-9f0c-8e6d4b2a1c30 schema: $ref: '#/components/schemas/ErrorResponse' '503': description: Servicio no disponible — una dependencia externa no está disponible. content: application/json: examples: service_unavailable: summary: External service unavailable value: error: type: api_error code: service_unavailable message: >- The service is temporarily unavailable. Please try again later. requestId: 3f9a1c2e-5b7d-4a21-9f0c-8e6d4b2a1c30 schema: $ref: '#/components/schemas/ErrorResponse' security: - BearerAuth: [] components: schemas: AuditReviewStatus: type: string enum: - pending - inReview - reviewed title: AuditReviewStatus description: Human-review state of an audit (filter value on the list endpoint). AuditListResponse: properties: items: items: $ref: '#/components/schemas/AuditListItem' type: array title: Items description: Page of audits. total: anyOf: - type: integer - type: 'null' title: Total description: Total audits in scope — always null (no server-side count). page: type: integer title: Page description: Current page number (1-based). limit: type: integer title: Limit description: Number of items per page. totalPages: anyOf: - type: integer - type: 'null' title: Totalpages description: Total pages — always null. hasMore: type: boolean title: Hasmore description: Whether another page exists. type: object required: - items - page - limit - hasMore title: AuditListResponse description: Paginated list of the institution's audits. examples: - hasMore: false items: - configuration: id: ac_9f8e7d6c5b4a3210 name: General medicine v2 version: '1.2' createdAt: '2026-02-20T10:35:00Z' grade: ACEPTABLE id: au_a1b2c3d4e5f6g7h8 origin: scribe patientName: John Doe reviewStatus: reviewed score: 0.82 limit: 20 page: 1 ErrorResponse: description: Envoltorio estandarizado de respuesta de error. properties: error: $ref: '#/components/schemas/ErrorDetailWithRequestId' required: - error title: ErrorResponse type: object AuditListItem: properties: id: type: string title: Id description: Stable audit identifier. examples: - au_a1b2c3d4e5f6g7h8 score: anyOf: - type: number - type: 'null' title: Score description: Weighted total quality score, 0..1. examples: - 0.82 grade: anyOf: - type: string - type: 'null' title: Grade description: Qualitative grade of the score. examples: - ACEPTABLE reviewStatus: anyOf: - type: string - type: 'null' title: Reviewstatus description: 'Human-review state: ''pending'', ''inReview'', or ''reviewed''.' origin: anyOf: - type: string - type: 'null' title: Origin description: How the audit was created (e.g. 'scribe'). examples: - scribe createdAt: anyOf: - type: string format: date-time - type: 'null' title: Createdat patientName: anyOf: - type: string - type: 'null' title: Patientname description: Name of the audited patient. configuration: anyOf: - $ref: '#/components/schemas/AuditConfigurationRef' - type: 'null' description: The rubric this audit was scored against (null for legacy audits). type: object required: - id title: AuditListItem description: >- One audit in the institution's audit list (overview; no per-section breakdown). ErrorDetailWithRequestId: description: >- Top-level error object: :class:`ErrorDetail` plus the request correlation id. Kept as a subclass rather than a field on ``ErrorDetail`` because ``ErrorDetail`` is also the per-item error shape inside the batch account-creation response (``BatchAccountResult.error``), which is serialized with nulls included. Adding the field there would publish ``"requestId": null`` on an HTTP 200, and there is only ever one request id per batch anyway -- batch callers read the ``X-Request-ID`` response header. properties: type: description: Broad error category for high-level handling. examples: - invalid_request_error title: Type type: string code: description: Machine-readable error code. Clients should switch on this value. examples: - parameter_invalid title: Code type: string message: description: Human-readable error message ending with a period. examples: - >- idCountry must be a valid country name, ISO alpha-2, or ISO alpha-3 code. title: Message type: string param: anyOf: - type: string - type: 'null' default: null description: The request field that caused the error, if applicable. examples: - idCountry title: Param details: anyOf: - additionalProperties: true type: object - type: 'null' default: null description: Optional structured, machine-readable context for the error. examples: - pendingConsultations: - sessionId: abc123 url: https://... title: Details requestId: anyOf: - type: string - type: 'null' default: null description: >- Unique id for this request, identical to the X-Request-ID response header. Quote it when contacting support. examples: - 3f9a1c2e-5b7d-4a21-9f0c-8e6d4b2a1c30 title: Requestid required: - type - code - message title: ErrorDetailWithRequestId type: object AuditConfigurationRef: properties: id: type: string title: Id examples: - ac_9f8e7d6c5b4a3210 name: anyOf: - type: string - type: 'null' title: Name examples: - General medicine v2 version: anyOf: - type: string - type: 'null' title: Version examples: - '1.2' type: object required: - id title: AuditConfigurationRef description: The rubric an audit was scored against. securitySchemes: BearerAuth: type: http scheme: bearer description: Clave API enviada como token Bearer ````