Skip to main content

GET Histórico de Status do Agendamento

Lista quem mudou o status do agendamento, de qual status para qual e quando, do mais recente para o mais antigo. Mostra só as alterações que mudam o status (inclusive uma remarcação que mudou o status). Para a linha do tempo completa, use Histórico de Alterações do Agendamento.

Autenticação necessária

Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.

Sem permissão específica

Não exige @CheckPermissions — basta estar autenticado.


Endpoint​

GET https://api-dev.imagemais.com.br/api/appointments/{id}/status-history

Parâmetros de Rota​

NomeTipoObrigatórioDescrição
idnumber✅ID do agendamento

Parâmetros de Query​

NomeTipoObrigatórioValores válidosDescrição
limitnumber❌inteiro de 1 a 100; padrão 20Itens por página
cursornumber❌inteiro positivoCursor de paginação (pagination.nextCursor da página anterior)

Requisição​

curl -X 'GET' \
'https://api-dev.imagemais.com.br/api/appointments/1/status-history?limit=20' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}'

Respostas​

200 Sucesso​

{
"data": [
{
"id": 120,
"type": "STATUS",
"from": {
"id": 1,
"name": "Agendado",
"color": "#0d6efd"
},
"to": {
"id": 2,
"name": "Confirmado",
"color": "#198754"
},
"changedAt": "2026-10-16T14:30:00.000Z",
"changedBy": {
"id": 345,
"name": "Nome Exemplo"
},
"source": "USER",
"changes": null
}
],
"pagination": {
"nextCursor": null
}
}

from é null na criação do agendamento; to é null quando a alteração não muda o status. changedBy é null quando a mudança foi do sistema ou de uma API Key. source: USER, API_KEY ou SYSTEM. pagination.nextCursor é null na última página.

400 Requisição inválida​

Retornado quando id não é numérico ou limit/cursor são inválidos:

{
"message": [
"limit must not be greater than 100"
],
"error": "Bad Request",
"statusCode": 400
}

404 Não encontrado​

{
"message": "Agendamento não encontrado",
"error": "Not Found",
"statusCode": 404
}

500 Erro interno​

{
"message": "Erro ao buscar histórico de status do agendamento",
"error": "Internal Server Error",
"statusCode": 500
}