Ver médico

GET/v1/doctors/:id

Um médico específico da empresa dona do token — mesmos campos da listagem, só que um só.

Exemplos de uso

curl "https://app.primevisita.com.br/v1/doctors/6a4c24b4a893d880917dfb6c" \
  -H "Authorization: Bearer SEU_TOKEN"

Parâmetros

idPathstringobrigatório

Descrição

Id do médico.

Como encontrar

Vem do campo id de cada item retornado por GET /v1/doctors — não existe outro jeito de descobrir o id por fora.

Exemplos de saída

200 — médico encontrado

200

{
  "data": {
    "id": "6a4c24b4a893d880917dfb6c",
    "fullName": "AHMAD JAMAL SALEH",
    "specialty": "NUTROLOGIA",
    "registrationCouncil": "CRM",
    "registrationNumber": "163123",
    "phone": "11 94002-9637",
    "professionalEmail": "contato@exemplo.com",
    "address": "R. Exemplo, 1040 - São Paulo, SP",
    "city": "São Paulo",
    "partnershipStatus": "PARCEIRO",
    "isRoutine": false,
    "createdAt": "2026-07-06T21:57:08.949Z",
    "updatedAt": "2026-07-24T20:35:49.169Z"
  }
}

Exemplos de erro

401 — token inválido

401

{ "error": "Token inválido ou revogado." }

403 — sem escopo

403

{ "error": "Este token não tem o escopo \"doctors:read\"." }

404 — não encontrado

404

Id inexistente, ou de um médico de outra empresa — a resposta é idêntica nos dois casos, de propósito, pra nunca revelar que um id existe em outro tenant.

{ "error": "Médico não encontrado." }