> ## 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. # Get a session's audit > Get the clinical-quality audit for a scribe session. Returns the weighted `score` (0..1), the qualitative `grade`, the per-section breakdown, and the rubric the audit was scored against. Returns `404` when the session has no audit — audit is disabled for it, or has not run yet. ## OpenAPI ````yaml /scribe-api/openapi.json get /v1/scribe-sessions/{id}/audit openapi: 3.1.0 info: title: Scribe Public API description: >- External-facing REST API for integrating with the Telepatia platform. Authenticate with API keys, set consultation context, and look up scribe sessions. version: 0.1.0 servers: - url: https://scribe-api.telepatia.ai description: Production security: - BearerAuth: [] paths: /v1/scribe-sessions/{id}/audit: get: tags: - Audits summary: Get a session's audit description: >- Get the clinical-quality audit for a scribe session. Returns the weighted `score` (0..1), the qualitative `grade`, the per-section breakdown, and the rubric the audit was scored against. Returns `404` when the session has no audit — audit is disabled for it, or has not run yet. operationId: api_session_audit_get_v1_scribe_sessions__id__audit_get parameters: - name: id in: path required: true schema: type: string minLength: 1 maxLength: 128 pattern: ^[a-zA-Z0-9_-]+$ description: >- The session to look up — either your consultationInternalId, or the session id (ss_...) the API returns. examples: - CONSULT-12345 - ss_sa98vgqyra91q5b8 title: Id description: >- The session to look up — either your consultationInternalId, or the session id (ss_...) the API returns. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/AuditResponse' example: configuration: id: ac_9f8e7d6c5b4a3210 name: General medicine v2 version: '1.2' createdAt: '2026-02-20T10:35:00Z' grade: ACEPTABLE id: au_a1b2c3d4e5f6g7h8 origin: scribe reviewStatus: reviewed score: 0.82 sections: - label: Anamnesis name: ANAMNESIS score: 0.9 - label: Physical exam name: PHYSICAL_EXAM score: 0.75 '400': description: >- Bad Request — invalid parameters, validation failures, or missing fields. 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: Unauthorized — missing or invalid API key. 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: Forbidden — the API key is not allowed to perform this operation. 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' '404': description: Not Found — the requested resource does not exist. content: application/json: examples: resource_not_found: summary: Resource not found value: error: type: invalid_request_error code: resource_not_found message: No session scribe found for the given consultation ID. requestId: 3f9a1c2e-5b7d-4a21-9f0c-8e6d4b2a1c30 schema: $ref: '#/components/schemas/ErrorResponse' '503': description: Service Unavailable — an external dependency is down. 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: AuditResponse: 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 configuration: anyOf: - $ref: '#/components/schemas/AuditConfigurationRef' - type: 'null' description: The rubric this audit was scored against (null for legacy audits). sections: items: $ref: '#/components/schemas/AuditSection' type: array title: Sections description: Per-section scores with their labels. type: object required: - id title: AuditResponse description: A scribe session's clinical-quality audit. examples: - configuration: id: ac_9f8e7d6c5b4a3210 name: General medicine v2 version: '1.2' createdAt: '2026-02-20T10:35:00Z' grade: ACEPTABLE id: au_a1b2c3d4e5f6g7h8 origin: scribe reviewStatus: reviewed score: 0.82 sections: - label: Anamnesis name: ANAMNESIS score: 0.9 - label: Physical exam name: PHYSICAL_EXAM score: 0.75 ErrorResponse: description: Standardized error response envelope. properties: error: $ref: '#/components/schemas/ErrorDetailWithRequestId' required: - error title: ErrorResponse 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. AuditSection: properties: name: type: string title: Name description: Section key of the rubric. examples: - ANAMNESIS label: type: string title: Label description: Human-readable section label. examples: - Anamnesis score: type: number title: Score description: Section score, 0..1. examples: - 0.9 type: object required: - name - label - score title: AuditSection description: One rubric section's score for an audit. 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 securitySchemes: BearerAuth: type: http scheme: bearer description: API key passed as a Bearer token ````