GET /v1/calendar/appointments
GET
/v1/calendar/appointments
const url = 'https://seu-endereco-da-api/v1/calendar/appointments?from=example&to=example';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://seu-endereco-da-api/v1/calendar/appointments?from=example&to=example' \ --header 'Authorization: Bearer <token>'Permissão que a Chave de acesso precisa: Ler agenda (calendar:read).
Authorizations
Seção intitulada “Authorizations”Parameters
Seção intitulada “Parameters”Query Parameters
Seção intitulada “Query Parameters”from
required
string
to
required
string
resourceId
string format: uuid
serviceId
string format: uuid
assignedUserId
string format: uuid
status
Array<string>
Separados por vírgula: agendado, confirmado, atendido, cancelado, faltou
cursor
string
limit
number
1 a 200; padrão 50
Responses
Seção intitulada “Responses”Media typeapplication/json
object
items
required
Array<object>
object
id
required
string
startsAt
required
string format: date-time
endsAt
required
string format: date-time
status
required
string
source
required
string
notes
required
string
cancelReason
required
string
createdAt
required
string format: date-time
resourceId
required
string
resourceName
required
string
resourceColor
required
string
timezone
required
string
ownerUserId
required
string
serviceId
required
string
serviceName
required
string
contactId
required
string
contactName
required
string
contactPhoneNumber
required
string
conversationId
required
string
createdByUserId
required
string
createdByName
required
string
reminderScheduleId
required
string
taskId
required
string
meetingUrl
required
Link da reunião (Google Meet ou o link fixo do profissional)
string
confirmedAt
required
Quando o contato confirmou presença
string format: date-time
nextCursor
required
string
Example generated
{ "items": [ { "id": "example", "startsAt": "2026-04-15T12:00:00Z", "endsAt": "2026-04-15T12:00:00Z", "status": "example", "source": "example", "notes": "example", "cancelReason": "example", "createdAt": "2026-04-15T12:00:00Z", "resourceId": "example", "resourceName": "example", "resourceColor": "example", "timezone": "example", "ownerUserId": "example", "serviceId": "example", "serviceName": "example", "contactId": "example", "contactName": "example", "contactPhoneNumber": "example", "conversationId": "example", "createdByUserId": "example", "createdByName": "example", "reminderScheduleId": "example", "taskId": "example", "meetingUrl": "example", "confirmedAt": "2026-04-15T12:00:00Z" } ], "nextCursor": "example"}