Historial de estado de uso

Referencia tecnica del endpoint Historial de estado de uso.

Quickstart Auth Errores

Descripcion

Devuelve el historial de cambios de estado operativo (uso).

Endpoint

Metodo: GET
Path: /api/v1/contracts/{id}/status-history

Query

start (opcional)
end (opcional)
page, per_page

Respuestas

200: historial
404: contrato no encontrado

Request

curl -X GET '$BASE/api/v1/contracts/123/status-history?start=2026-02-01&end=2026-02-28' \
  -H 'Authorization: Bearer $TOKEN'

curl -X GET '$BASE/api/v1/contracts/123/status-history?start=2026-02-01&end=2026-02-28' \
  -H 'Authorization: Bearer $TOKEN'

Response

{
  "contractId":123,
  "data":[{"statusFrom":"ACTIVE","statusTo":"WARNING_USAGE","reasons":["API_CALL alcanzando limite (850/1000)"],"createdAt":"2026-02-10T15:30:00Z"}],
  "pagination":{"page":1,"per_page":50,"total":1}
}

{
  "contractId":123,
  "data":[{"statusFrom":"ACTIVE","statusTo":"WARNING_USAGE","reasons":["API_CALL alcanzando limite (850/1000)"],"createdAt":"2026-02-10T15:30:00Z"}],
  "pagination":{"page":1,"per_page":50,"total":1}
}