Ver agendamento

GET/v1/appointments/:id

Um agendamento específico da empresa dona do token.

Exemplos de uso

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

Parâmetros

idPathstringobrigatório

Descrição

Id do agendamento.

Como encontrar

Vem do campo id de cada item retornado por GET /v1/appointments.

Exemplos de saída

200 — agendamento encontrado

200

{
  "data": {
    "id": "6a4d18dcc56c1026a5d0c138",
    "doctorId": "6a4c24b6a893d880917dfc48",
    "doctorName": "SERGIO ZILIO",
    "scheduledAt": "2026-12-12T15:00:00.000Z",
    "mode": "VIDEO",
    "status": "REALIZADO",
    "result": "JA_E_PARCEIRO",
    "observations": null,
    "createdAt": "2026-07-07T15:18:52.993Z",
    "updatedAt": "2026-07-08T16:08:29.560Z"
  }
}

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

404 — não encontrado

404

Id inexistente, ou de um agendamento de outra empresa.

{ "error": "Agendamento não encontrado." }