> ## 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 pacientes > Lista os pacientes visíveis para o chamador autenticado, paginados. ## OpenAPI ````yaml /pt-BR/scribe-api/openapi-institutional.json get /v1/patients openapi: 3.1.0 info: title: Scribe Public API description: >- API REST externa para integração com a plataforma Telepatia. Autentique-se com chaves de API, defina o contexto da consulta e busque sessões de scribe. version: 0.1.0 servers: - url: https://scribe-api.telepatia.ai description: Production security: - BearerAuth: [] paths: /v1/patients: get: tags: - Patients summary: Listar pacientes description: Lista os pacientes visíveis para o chamador autenticado, paginados. operationId: api_patient_list_v1_patients_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. responses: '200': description: Resposta bem-sucedida content: application/json: schema: $ref: '#/components/schemas/PatientListResponse' '400': description: >- Requisição inválida — parâmetros inválidos, falhas de validação ou campos ausentes. 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: Não autorizado — chave de API ausente ou 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. schema: $ref: '#/components/schemas/ErrorResponse' '503': description: Serviço indisponível — uma dependência externa está indisponível. 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: PatientListResponse: properties: items: items: $ref: '#/components/schemas/PatientResponse' type: array title: Items description: Page of patients. total: anyOf: - type: integer - type: 'null' title: Total description: Total patients matching the caller's scope (null on later pages). 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 number of pages (null when the total is unknown). hasMore: type: boolean title: Hasmore description: Whether another page likely exists (accurate on every page). type: object required: - items - page - limit - hasMore title: PatientListResponse description: Paginated list of patients. ErrorResponse: description: Envelope padronizado de resposta de erro. properties: error: $ref: '#/components/schemas/ErrorDetail' required: - error title: ErrorResponse type: object PatientResponse: properties: id: type: string title: Id description: Stable public identifier. examples: - sp_a1b2c3d4e5f6g7h8 name: type: string title: Name examples: - John Doe idCountry: anyOf: - type: string - type: 'null' title: Idcountry examples: - COLOMBIA idType: anyOf: - type: string - type: 'null' title: Idtype examples: - CC idValue: anyOf: - type: string - type: 'null' title: Idvalue examples: - '1024567890' createdAt: type: string title: Createdat description: ISO-8601 timestamp when the patient was created. type: object required: - id - name - createdAt title: PatientResponse description: A single patient. `id` is the stable public id (sp_...). examples: - createdAt: '2026-07-01T12:00:00.000Z' id: sp_a1b2c3d4e5f6g7h8 idCountry: COLOMBIA idType: CC idValue: '1024567890' name: John Doe ErrorDetail: description: >- Detalhe do erro com códigos legíveis por máquina e mensagem legível por humanos. 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: Chave de API enviada como token Bearer ````