> ## 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 doctor account > Retrieve a doctor account by its `publicId` (format: `acc_*`) or by its `internalCode` (your institution's internal identifier). ## OpenAPI ````yaml /pt-BR/scribe-api/openapi-institutional.json get /v1/institutional/accounts/{account_id} 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/institutional/accounts/{account_id}: get: tags: - Institutional - Institutional summary: Get a doctor account description: >- Retrieve a doctor account by its `publicId` (format: `acc_*`) or by its `internalCode` (your institution's internal identifier). operationId: >- api_institutional_account_retrieved_v1_institutional_accounts__account_id__get parameters: - name: account_id in: path required: true schema: type: string title: Account Id responses: '200': description: Resposta bem-sucedida content: application/json: schema: $ref: '#/components/schemas/GetAccountResponse' example: createdAt: '2024-01-15T10:30:00Z' doctorSpecialties: - cardiology email: dr.juan@clinica.com enabled: true id: acc_a1b2c3d4e5f6g7h8 internalCode: DOC-001 nameFull: Dr. Juan Pérez '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' '404': description: Não encontrado — o recurso solicitado não existe. 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: 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: GetAccountResponse: properties: id: type: string title: Id description: Account publicId (acc_*). examples: - acc_a1b2c3d4e5f6g7h8 email: type: string title: Email examples: - dr.juan@clinica.com nameFull: anyOf: - type: string - type: 'null' title: Namefull examples: - Dr. Juan Pérez doctorSpecialties: items: $ref: '#/components/schemas/MedicalSpecialty' type: array title: Doctorspecialties examples: - - cardiology enabled: type: boolean title: Enabled examples: - true internalCode: anyOf: - type: string - type: 'null' title: Internalcode examples: - DOC-001 createdAt: type: string title: Createdat examples: - '2024-01-15T10:30:00Z' type: object required: - id - email - doctorSpecialties - enabled - createdAt title: GetAccountResponse description: Response body for fetching an institutional doctor account. examples: - createdAt: '2024-01-15T10:30:00Z' doctorSpecialties: - cardiology email: dr.juan@clinica.com enabled: true id: acc_a1b2c3d4e5f6g7h8 internalCode: DOC-001 nameFull: Dr. Juan Pérez ErrorResponse: description: Envelope padronizado de resposta de erro. properties: error: $ref: '#/components/schemas/ErrorDetail' required: - error title: ErrorResponse type: object MedicalSpecialty: type: string enum: - acupuncture - alternativeMedicine - ayurvedicMedicine - chiropractic - herbalMedicine - homeopathy - naturopathy - traditionalChineseMedicine - cosmeticDentistry - dentistry - developmentalBehavioralPediatrics - endodontics - forensicDentistry - maxillofacialProsthodontics - oralMaxillofacialSurgery - oralMedicine - oralPathology - oralSurgery - orthodontics - pediatricDentistry - periodontics - prosthodontics - addictionPsychiatry - adolescentMedicine - aerospaceMedicine - allergyImmunology - andrology - anesthesiology - anesthesiologyCriticalCare - bariatricSurgery - breastRadiology - breastSurgery - cardiacSurgery - cardiovascularSurgery - cardiology - cardiovascularDisease - cardiovascularRiskProgram - childAbusePediatrics - childAdolescentPsychiatry - childNeurology - childWelfareSocialWork - clinicalNeurophysiology - clinicalSocialWork - colorectalSurgery - communityMedicine - communitySocialWork - consultationLiaisonPsychiatry - cosmeticDermatology - craniofacialTrauma - dermatology - dermoscopy - diabetes - diagnosticRadiology - electrophysiology - emergencyCriticalCare - emergencyMedicine - emergencyPsychiatry - endocrineSurgery - endocrinology - epilepsy - facialPlasticSurgery - familyMedicine - familySocialWork - footAnkleSurgery - forensicPsychiatry - forensicSocialWork - gastroenterology - generalMedicine - generalMedicinePsychiatry - generalSurgery - geriatricMedicine - geriatricPsychiatry - geriatricSocialWork - ginecology - gynecologicOncology - gynecologicSurgery - gynecology - handSurgery - headNeckSurgery - headacheMedicine - heartFailureTransplantCardiology - hematology - hepatobiliarySurgery - hipKneeSurgery - hospitalist - infectiousDisease - internalCriticalCare - internalMedicine - interventionalCardiology - interventionalRadiology - maternalFetalMedicine - medicalSocialWork - militarySocialWork - minimallyInvasiveGynecologicSurgery - mohsSurgery - musculoskeletalRadiology - neonatology - nephrology - neurocriticalCare - neuroimmunology - neurology - neuromuscularMedicine - neuroradiology - neurorehabilitation - neurosurgery - neurotology - nuclearMedicine - obstetrics - obstetricsGynecology - occupationalMedicine - occupationalSocialWork - oculoplasticSurgery - oncology - oncologySocialWork - ophthalmology - orthopedicHandSurgery - orthopedicSportsMedicine - orthopedicTrauma - orthopedics - otolaryngology - painMedicine - palliativeMedicine - palliativeSocialWork - pediatricAllergyImmunology - pediatricAnesthesiology - pediatricCardiology - pediatricCriticalCare - pediatricDermatology - pediatricEmergencyMedicine - pediatricEndocrinology - pediatricENT - pediatricGastroenterology - pediatricHematologyOncology - pediatricInfectiousDisease - pediatricNephrology - pediatricNeurology - pediatricCardiacSurgery - pediatricOncology - pediatricOphthalmology - pediatricOrthopedics - pediatricPalliativeCare - pediatricPulmonology - pediatricRadiology - pediatricRheumatology - pediatricSocialWork - pediatricSurgery - pediatricTrauma - pediatricUrology - pediatrics - perinatalPsychiatry - physicalMedicineRehab - plasticSurgery - prenatalCareProgram - preventiveMedicine - psychiatricSocialWork - psychiatry - psychosomaticMedicine - publicHealth - pulmonaryDisease - pulmonology - radiationOncologist - radiationOncology - reproductiveEndocrinology - retinaSurgery - rheumatology - riasProgram - manager - schoolSocialWork - shoulderElbowSurgery - sleepMedicine - socialWork - spinalCordInjury - spinalTrauma - spineSurgery - sportsMedicine - substanceAbuseSocialWork - surgicalOncology - telemedicine - thoracicSurgery - transplantHepatology - transplantSurgery - traumaSurgery - traumatology - triage - unknown - urgentCare - urologicOncology - urology - vascularSurgery - nursing - clinicalNutrition - eatingDisorderNutrition - gastroenterologicNutrition - geriatricNutrition - nutrition - oncologyNutrition - pediatricNutrition - renalNutrition - sportsNutrition - clinicalPsychology - counselingPsychology - developmentalPsychology - forensicPsychology - geropsychology - healthPsychology - industrialOrganizationalPsychology - militaryPsychology - neuropsychology - positivePsychology - psychology - rehabilitationPsychology - schoolPsychology - sportsPsychology - occupationalTherapy - physicalTherapy - respiratoryTherapy - speechTherapy - therapy - other title: MedicalSpecialty 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 ````