Pular para o conteúdo principal

Consultar disponibilidade

ConsultaOperação
Quais horários estão livres neste período?GET /executor-agenda/disponibilidade

Horários disponíveis entre a data inicial e a data final​

curl -G "https://api.clinicanasnuvens.com.br/executor-agenda/disponibilidade" \
  -H "Authorization: Basic <CREDENCIAIS_EM_BASE64>" \
  -H "clinicaNasNuvens-cid: <TOKEN_DA_CLINICA>" \
  --data-urlencode "idExecutorAgenda=1" \
  --data-urlencode "data=2026-10-05" \
  --data-urlencode "dataFim=2026-10-10"

O idExecutorAgenda recebe o id do executor (ver Identificadores da agenda). Quando dataFim não é informada, a consulta considera apenas a data. Cada item da resposta é um intervalo disponível, com a duração do tempo médio do profissional para aquele tipo de consulta. Quando não há horários disponíveis, a resposta é uma lista vazia.

Intervalo máximo. O período consultado é de até 15 dias, e não é possível consultar períodos maiores. Para períodos mais longos, a consulta é dividida em intervalos de até 15 dias, observando o limite de requisições.

Próximo passo​

Com o horário escolhido, siga para Criar um agendamento.

Veja na Referência​

Os detalhes de cada operação, campo a campo, estão em Referência › Disponibilidade e em Referência › Executores de agenda.