Webservice V1
Consumo por Chip
GET

Consumo por Chip

/activations/consumption/chip/{identifier}

Consulta o consumo de um único chip. Todos os volumes vêm em MB. Em planos ilimitados, unlimited=true e franquia/saldo/percentual vêm null.

Importante
Recurso restrito: a agência precisa ter a consulta de consumo habilitada (allow_consumption_query). Sem a permissão, a resposta é 403.

O chip é resolvido pelo ICC, EID, IMEI2 ou número da linha, sempre dentro do escopo da agência autenticada. Havendo mais de um item para o mesmo identificador, vence o mais recente.

Headers

Accept
text
application/json
Authorization
text
Bearer {{TOKEN}}

Parâmetros

identifier
Stringpathobrigatório

Valor usado para substituir {identifier} na rota.

ex: 8955010012345678909

Respostas

Consumo por Chip
{
  "status": "success",
  "message": "Consumo consultado com sucesso.",
  "data": {
    "order_id": 25360,
    "external_id": "434",
    "activation_type": "chip",
    "chip": {
      "sequence": 25869,
      "identifier": "8955010012345678909",
      "available": true,
      "unlimited": false,
      "total_used_mb": 3584,
      "allowance_mb": 5120,
      "remaining_mb": 1536,
      "usage_percentage": 70,
      "last_usage_at": "2026-09-21",
      "fetched_at": "2026-09-22T13:40:05-03:00",
      "history": [
        {
          "date": "2026-09-21",
          "used_mb": 820
        },
        {
          "date": "2026-09-20",
          "used_mb": 640
        }
      ]
    }
  }
}