> ## 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. # List Medical Record Documents > List the medical record documents produced for a scribe session. ## OpenAPI ````yaml /scribe-api/openapi.json get /v1/scribe-sessions/{id}/medical-record-documents 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}/medical-record-documents: get: tags: - Medical Record Documents summary: List Medical Record Documents description: List the medical record documents produced for a scribe session. operationId: >- api_medical_record_documents_listed_v1_scribe_sessions__id__medical_record_documents_get parameters: - name: id in: path required: true schema: type: string minLength: 1 maxLength: 128 pattern: ^[a-zA-Z0-9_-]+$ description: The consultation internal ID to look up examples: - CONSULT-12345 title: Id description: The consultation internal ID to look up - name: purpose in: query required: false schema: anyOf: - type: string minLength: 1 maxLength: 255 - type: 'null' description: Optional filter — return only documents with this purpose. examples: - primary title: Purpose description: Optional filter — return only documents with this purpose. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/MedicalRecordDocumentListResponse' example: items: - cdssAlerts: - action: Suspend ibuprofen; consider paracetamol. actionCategory: replace element: Ibuprofen 600mg q8h elementId: IBUPROFEN id: cfa_bXJkLWFiYy0xMjMfSUJVUFJPRkVO issue: not_pertinent newPlanElement: content: Paracetamol 1g q8h PO element: Paracetamol id: PARACETAMOL type: medication reason: NSAID contraindicated with documented CKD. severity: red source: - KDIGO 2024 CKD guideline status: pending type: medication createdAt: '2026-02-20T10:30:00Z' diagnosisCodes: - code: I10 description: Essential (primary) hypertension type: primary id: mrd-abc-123 language: en medicalRecord: sections: [] medicalRecordSummary: Patient presents with chest pain. medicalRecordSummaryStructured: pastMedicalConditions: - Hypertension pastMedicalConditionsCoded: - code: code: I10 options: - code: I10 score: 0.98 content: Hypertension vitalSigns: bloodPressure: 120/80 purpose: primary specialty: Cardiology updatedAt: '2026-02-20T10:35:00Z' total: 1 '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 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 account_invalid: summary: Invalid account value: error: type: invalid_request_error code: account_invalid message: Account has no valid authId. 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. schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Forbidden 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. 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. 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: >- Unable to generate verification code. Please try again later. schema: $ref: '#/components/schemas/ErrorResponse' security: - BearerAuth: [] components: schemas: MedicalRecordDocumentListResponse: properties: items: items: $ref: '#/components/schemas/MedicalRecordDocumentItem' type: array title: Items description: Medical record documents for the session, one per purpose. total: type: integer title: Total description: Total number of medical record documents. type: object required: - items - total title: MedicalRecordDocumentListResponse description: Response body for listing a scribe session's medical record documents. examples: - items: - cdssAlerts: - action: Suspend ibuprofen; consider paracetamol. actionCategory: replace element: Ibuprofen 600mg q8h elementId: IBUPROFEN id: cfa_bXJkLWFiYy0xMjMfSUJVUFJPRkVO issue: not_pertinent newPlanElement: content: Paracetamol 1g q8h PO element: Paracetamol id: PARACETAMOL type: medication reason: NSAID contraindicated with documented CKD. severity: red source: - KDIGO 2024 CKD guideline status: pending type: medication createdAt: '2026-02-20T10:30:00Z' diagnosisCodes: - code: I10 description: Essential (primary) hypertension type: primary id: mrd-abc-123 language: en medicalRecord: sections: [] medicalRecordSummary: Patient presents with chest pain. medicalRecordSummaryStructured: pastMedicalConditions: - Hypertension pastMedicalConditionsCoded: - code: code: I10 options: - code: I10 score: 0.98 content: Hypertension vitalSigns: bloodPressure: 120/80 purpose: primary specialty: Cardiology updatedAt: '2026-02-20T10:35:00Z' total: 1 ErrorResponse: description: Standardized error response envelope. properties: error: $ref: '#/components/schemas/ErrorDetail' required: - error title: ErrorResponse type: object MedicalRecordDocumentItem: properties: id: type: string maxLength: 255 title: Id examples: - mrd-abc-123 purpose: type: string maxLength: 255 title: Purpose description: >- Identifies the record when a session produced several (e.g. 'primary', 'rpa', 'emr'). examples: - primary specialty: anyOf: - type: string - type: 'null' title: Specialty description: Medical specialty associated with the record. examples: - Cardiology language: anyOf: - type: string - type: 'null' title: Language description: Language of the record content. examples: - en medicalRecordSummary: anyOf: - type: string - type: 'null' title: Medicalrecordsummary description: Plain-text summary of the medical record. createdAt: anyOf: - type: string format: date-time - type: 'null' title: Createdat examples: - '2026-02-20T10:30:00Z' updatedAt: anyOf: - type: string format: date-time - type: 'null' title: Updatedat examples: - '2026-02-20T10:35:00Z' medicalRecord: anyOf: - additionalProperties: true type: object - type: 'null' title: Medicalrecord description: >- The medical record as an opaque JSON object (the MRG `{ sections: [...] }` payload). medicalRecordSummaryStructured: anyOf: - additionalProperties: true type: object - type: 'null' title: Medicalrecordsummarystructured description: >- Structured summary: vital signs, medication, past conditions, recent labs/imaging, and last consultation. Includes `pastMedicalConditionsCoded` — the past conditions with resolved ICD-10 codes (`content` plus a `code` object with the best `code` and scored `options`) — which is `null` until code resolution has run for the record. diagnosisCodes: items: $ref: '#/components/schemas/DiagnosisCode' type: array title: Diagnosiscodes description: >- Diagnosis ICD-10 (CIE-10 / CID-10) codes for the record — the doctor-curated set (model suggestions plus doctor additions, minus deletions). Empty when the session has no diagnosis codes. cdssAlerts: anyOf: - items: $ref: '#/components/schemas/CdssAlert' type: array - type: 'null' title: Cdssalerts description: >- Corrective CDSS ('conducta feedback') alerts for this record. `null` when clinical decision support is disabled for the session or no alerts were generated; `[]` when it ran and produced none. type: object required: - id - purpose title: MedicalRecordDocumentItem description: A medical record document produced for a scribe session. ErrorDetail: description: Error detail with machine-readable codes and human-readable message. 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 required: - type - code - message title: ErrorDetail type: object DiagnosisCode: properties: code: type: string title: Code examples: - I10 description: type: string title: Description description: Localized description of the code (may be empty for legacy records). examples: - Essential (primary) hypertension type: type: string enum: - primary - secondary title: Type description: Whether the code is the primary diagnosis or a secondary one. examples: - primary type: object required: - code - description - type title: DiagnosisCode description: A single diagnosis ICD-10 (CIE-10 / CID-10) code the record documents. CdssAlert: properties: id: type: string title: Id description: >- Stable opaque identifier for the alert. Use it as-is; do not parse it. elementId: type: string title: Elementid description: >- Clinical element key (e.g. 'IBUPROFEN'). Human-meaningful but not unique across documents — never use it as an identifier. reason: type: string title: Reason action: type: string title: Action actionCategory: type: string title: Actioncategory type: type: string title: Type issue: type: string title: Issue element: type: string title: Element severity: type: string title: Severity source: items: type: string type: array title: Source newPlanElement: anyOf: - $ref: '#/components/schemas/CdssAlertNewPlanElement' - type: 'null' previousTestDate: anyOf: - type: string - type: 'null' title: Previoustestdate guidelineIntervalDays: anyOf: - type: integer - type: 'null' title: Guidelineintervaldays status: type: string title: Status description: >- Doctor's decision on the alert: 'pending', 'accepted', or 'rejected'. default: pending type: object required: - id - elementId - reason - action - actionCategory - type - issue - element - severity title: CdssAlert description: A single corrective CDSS alert as exposed on the public API. CdssAlertNewPlanElement: properties: type: type: string title: Type element: type: string title: Element id: type: string title: Id content: type: string title: Content laboratory: anyOf: - type: string - type: 'null' title: Laboratory type: object required: - type - element - id - content title: CdssAlertNewPlanElement description: The plan element a CDSS alert proposes (present on add/replace/modify). securitySchemes: BearerAuth: type: http scheme: bearer description: API key passed as a Bearer token ````