Listar médicos

GET/v1/doctors

Lista os médicos da empresa dona do token, mais recentes junto com todo o cadastro — nunca inclui médico de outra empresa, mesmo que o id seja adivinhado.

Exemplos de uso

curl "https://app.primevisita.com.br/v1/doctors?page=1&perPage=30" \
  -H "Authorization: Bearer SEU_TOKEN"

Parâmetros

specialtyQuery stringstring

Descrição

Filtra por especialidade exata (mesmo valor salvo no cadastro do médico, sensível a maiúsculas/minúsculas).

Como encontrar

Copie o valor exato de specialty de um médico já retornado por esta mesma rota, sem filtro — não existe endpoint separado de "lista de especialidades" na API pública.

partnershipStatusQuery stringstring

Descrição

Filtra pelo status de parceria: PENDENTE, PROSPECCAO, PARCEIRO ou RECUSADO.

Como encontrar

Um dos 4 valores fixos ao lado — não precisa consultar nada, são sempre os mesmos.

pageQuery stringnumber

Descrição

Página dos resultados, começando em 1. Padrão: 1.

Como encontrar

Comece sem esse parâmetro (primeira página) e use o totalPages da resposta pra saber até onde paginar.

perPageQuery stringnumber

Descrição

Itens por página, de 1 a 100. Padrão: 30.

Como encontrar

Escolha livre — 100 é o teto aceito pela rota.

Exemplos de saída

200 — lista paginada

200

phone, professionalEmail, address e city podem vir null — nem todo médico tem esses campos preenchidos.

{
  "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"
    }
  ],
  "page": 1,
  "perPage": 30,
  "total": 418,
  "totalPages": 14
}

Exemplos de erro

401 — token ausente

401

{ "error": "Token de acesso ausente. Envie \"Authorization: Bearer <token>\"." }

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\"." }

429 — limite excedido

429

{ "error": "Limite de requisições excedido." }

503 — rota desativada

503

{ "error": "Esta rota está temporariamente desativada." }