> ## 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. # Look Up Scribe Session > Look up a scribe session by ID. ## OpenAPI ````yaml /scribe-api/openapi.json get /v1/scribe-sessions/{id} 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}: get: tags: - Session Scribes summary: Look Up Scribe Session description: Look up a scribe session by ID. operationId: api_scribe_session_retrieved_v1_scribe_sessions__id__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 responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/SessionScribeLookupResponse' example: completedAt: '2026-02-20T10:30:00Z' consultationInternalId: CONSULT-12345 createdAt: '2026-02-20T10:00:00Z' id: ss_a1b2c3d4e5f6g7h8 patientName: John Doe scribeSessionModality: IN_PERSON specialty: Cardiology status: completed '400': description: >- Bad Request — invalid parameters, validation failures, or missing fields. content: application/json: examples: parameter_invalid: summary: Invalid consultation ID format value: error: type: invalid_request_error code: parameter_invalid message: >- id must contain only alphanumeric characters, hyphens, and underscores. param: id account_invalid: summary: Account has no auth ID 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' '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' '428': description: Precondition Required content: application/json: examples: cdss_review_required: summary: Doctor has pending CDSS suggestions awaiting review value: error: type: invalid_request_error code: cdss_review_required message: >- This doctor has 1 pending CDSS suggestion awaiting review from the last 7 days. The API is blocked by your institution until the suggestions are reviewed. Open the consultation(s) to accept or reject them: https://scribe.telepatia.ai/consultations/session-abc-123. details: pendingConsultations: - sessionId: session-abc-123 url: >- https://scribe.telepatia.ai/consultations/session-abc-123 schema: $ref: '#/components/schemas/ErrorResponse' '503': description: Service Unavailable — an external dependency is down. content: application/json: examples: service_unavailable: summary: Failed to look up session scribe value: error: type: api_error code: service_unavailable message: >- Failed to look up session scribe. Please try again later. schema: $ref: '#/components/schemas/ErrorResponse' security: - BearerAuth: [] components: schemas: SessionScribeLookupResponse: properties: id: type: string maxLength: 255 title: Id examples: - ss_a1b2c3d4e5f6g7h8 status: type: string maxLength: 255 title: Status examples: - completed createdAt: anyOf: - type: string format: date-time - type: 'null' title: Createdat examples: - '2026-02-20T10:00:00Z' completedAt: anyOf: - type: string format: date-time - type: 'null' title: Completedat examples: - '2026-02-20T10:30:00Z' patientName: anyOf: - type: string maxLength: 255 - type: 'null' title: Patientname examples: - John Doe scribeSessionModality: anyOf: - type: string - type: 'null' title: Scribesessionmodality description: >- The modality of the scribe session (e.g. 'IN_PERSON', 'TELEMEDICINE'). examples: - IN_PERSON consultationInternalId: anyOf: - type: string - type: 'null' title: Consultationinternalid description: The consultation ID provided by the API consumer. examples: - CONSULT-12345 specialty: anyOf: - type: string - type: 'null' title: Specialty description: The medical specialty of the clinician who conducted the session. examples: - Cardiology type: object required: - id - status title: SessionScribeLookupResponse description: Response body for session scribe lookup. examples: - completedAt: '2026-02-20T10:30:00Z' consultationInternalId: CONSULT-12345 createdAt: '2026-02-20T10:00:00Z' id: ss_a1b2c3d4e5f6g7h8 patientName: John Doe scribeSessionModality: IN_PERSON specialty: Cardiology status: completed ErrorResponse: description: Standardized error response envelope. properties: error: $ref: '#/components/schemas/ErrorDetail' required: - error title: ErrorResponse type: object 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 securitySchemes: BearerAuth: type: http scheme: bearer description: API key passed as a Bearer token ````