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.
Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.
Não exige @CheckPermissions — basta estar autenticado.
Endpoint
GET https://api-dev.imagemais.com.br/api/appointments/{id}/status-history
Parâmetros de Rota
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | number | ✅ | ID do agendamento |
Parâmetros de Query
| Nome | Tipo | Obrigatório | Valores válidos | Descrição |
|---|---|---|---|---|
limit | number | ❌ | inteiro de 1 a 100; padrão 20 | Itens por página |
cursor | number | ❌ | inteiro positivo | Cursor 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
}