Consumo diário

Responde à pergunta “quanto eu gastei em cada dia, e com qual tipo de mensagem?”. O valor já vem somado por dia e por tipo, para a conta inteira (todos os canais): você não precisa paginar nem somar lançamentos.

curl "https://api-dev.messagefy.io/api/v1/billing/Usage/Daily?from=2026-10-01&to=2026-10-31" \
  -H "API-KEY: acc_..."

Parâmetros

date

required

Primeiro dia do período. Ele entra no resultado.

Formato: só a data, yyyy-MM-dd (ex.: 2026-10-01). Não envie hora: 2026-10-01T00:00:00Z é recusado com 400.
O dia é contado no horário de Brasília (veja “Como o dia é contado”, abaixo).

date

required

Último dia do período. Ele também entra no resultado.

Mesmo formato do from: yyyy-MM-dd, sem hora.
Precisa ser igual ou posterior ao from. Para um dia só, repita a data: from=2026-10-14&to=2026-10-14.
No máximo 92 dias no período, contando o from e o to. Para mais tempo, faça uma chamada por trecho.
Pode ser um dia futuro: os dias que ainda não aconteceram simplesmente não aparecem.

string

Opcional. Traz só os tipos de mensagem que você pedir, com o código da tabela Tipos de mensagem, no fim desta página (ex.: meta-marketing).

Um tipo: type=meta-marketing.
Vários: repita o parâmetro, type=meta-marketing&type=meta-utility.
Sem type: todos os tipos.

string

default:"BRL"

Moeda (ISO 4217). Outro formato é recusado com 400.

uuid

Só para chaves org_: a conta a consultar. Com chave acc_, a conta vem da chave.

Exemplos de período

Quero ver	`from`	`to`	Dias no período
Só o dia 14 de outubro	`2026-10-14`	`2026-10-14`	1
A semana de 12 a 18 de outubro	`2026-10-12`	`2026-10-18`	7
Outubro inteiro	`2026-10-01`	`2026-10-31`	31
Fevereiro inteiro	`2026-02-01`	`2026-02-28`	28
O maior período aceito	`2026-07-15`	`2026-10-14`	92
Período recusado (`400`)	`2026-07-14`	`2026-10-14`	93: acima do limite
Período recusado (`400`)	`2026-10-14`	`2026-10-01`	`to` antes do `from`

from e to são dias no horário de Brasília, e o to entra no resultado: para outubro inteiro, use to=2026-10-31, e não 2026-11-01.

Como o dia é contado

O dia vai da 00:00 às 23:59 no horário de Brasília, e cada mensagem entra no dia em que foi enviada, nesse horário. O fuso usado vem sempre no campo timeZone da resposta.

Mensagem enviada em (UTC)	No horário de Brasília	Aparece no dia
`2026-10-14T13:00:00Z`	14/10 às 10:00	`2026-10-14`
`2026-10-15T02:30:00Z`	14/10 às 23:30	`2026-10-14` (e não no dia 15)
`2026-10-15T03:00:00Z`	15/10 às 00:00	`2026-10-15`

Se a sua aplicação trabalha em UTC, converta para o horário de Brasília antes de comparar com o date da resposta.

Resposta

Para from=2026-10-13&to=2026-10-14:

{
  "account": { "id": "11111111-1111-1111-1111-111111111111" },
  "currency": "BRL",
  "timeZone": "America/Sao_Paulo",
  "from": "2026-10-13",
  "to": "2026-10-14",
  "days": [
    {
      "date": "2026-10-14",
      "total": 0.5222,
      "items": [
        { "type": "meta-marketing", "quantity": 1, "amount": 0.3717 },
        { "type": "meta-utility", "quantity": 3, "amount": 0.1455 },
        { "type": "inbound", "quantity": 1, "amount": 0.0050 }
      ]
    },
    {
      "date": "2026-10-13",
      "total": 0.3717,
      "items": [
        { "type": "meta-marketing", "quantity": 1, "amount": 0.3717 }
      ]
    }
  ]
}

Lendo esse exemplo: no dia 14 a conta gastou **R

0,5222**, sendo 1 mensagem de marketing (R

0,3717), 3 de utilidade (R

0,1455 no total, não cada uma) e 1 mensagem recebida (R

0,0050). No dia 13, 1 mensagem de marketing.

Campos da resposta

Campo	O que é	Exemplo
`account.id`	A sua conta	`11111111-...`
`currency`	Moeda de todos os valores da resposta (ISO 4217)	`BRL` = reais
`timeZone`	Fuso em que os dias foram contados	`America/Sao_Paulo` = horário de Brasília
`from` / `to`	O período pedido, repetido como você enviou	`2026-10-13` / `2026-10-14`
`days`	Um item por dia que teve consumo, do mais recente para o mais antigo. Dia sem nenhuma mensagem cobrada não aparece; sem consumo no período inteiro, vem `[]`	2 itens: dia 14, depois dia 13
`days[].date`	O dia (`yyyy-MM-dd`, horário de Brasília)	`2026-10-14`
`days[].total`	Quanto foi cobrado no dia: a soma dos `amount` dos `items` daquele dia	`0.5222` = R$ 0,5222
`days[].items`	Um item por tipo de mensagem cobrado no dia, do maior valor para o menor	3 itens no dia 14
`items[].type`	O tipo de mensagem: o código da tabela Tipos de mensagem, no fim desta página	`meta-utility` = utilidade
`items[].quantity`	Quantas mensagens desse tipo foram cobradas no dia	`3`
`items[].amount`	O valor somado dessas mensagens no dia (não é o preço unitário)	`0.1455` para as 3 juntas

Os valores têm até 4 casas decimais (ex.: 0.3717 = R$ 0,3717). Para exibir em reais, arredonde só na tela. Com o filtro type, os items trazem só os tipos pedidos, e o total de cada dia passa a ser a soma desses tipos. Por exemplo, com type=meta-marketing o dia 14 do exemplo viria com total: 0.3717 e um item só.

Estornos e ajustes

O consumo mostra o valor final de cada mensagem, sempre no dia em que ela foi enviada, mesmo que a correção chegue dias depois. Por isso, um dia já consultado pode mudar. Estorno (a Meta não entregou a mensagem): a mensagem sai da contagem e o valor dela sai do total.

	Dia 14, utilidade
Antes do estorno	`quantity: 3`, `amount: 0.1455`
Depois do estorno de uma delas	`quantity: 2`, `amount: 0.0970`

Ajuste de categoria (a Meta cobrou outra categoria): a mensagem muda de tipo, com o preço do tipo novo. Ela nunca aparece nos dois tipos ao mesmo tempo.

	Dia 14, utilidade	Dia 14, marketing
Antes do ajuste	`quantity: 3`, `amount: 0.1455`	`quantity: 1`, `amount: 0.3717`
Uma mensagem de utilidade passa a marketing	`quantity: 2`, `amount: 0.0970`	`quantity: 2`, `amount: 0.7434`

Cada estorno e cada ajuste também aparece nos lançamentos, com a data em que foi lançado.

Erros mais comuns

O que aconteceu	Resposta	Como corrigir
Faltou o `from` ou o `to`	`400` com `errorCode` `STATEMENT_RANGE_INVALID`	Envie os dois
`to` antes do `from`	`400` com `errorCode` `STATEMENT_RANGE_INVALID`	Troque as datas
Período acima de 92 dias	`400` com `errorCode` `STATEMENT_RANGE_INVALID`	Divida em chamadas de até 92 dias
Data com hora (`2026-10-14T00:00:00Z`) ou em outro formato (`14/10/2026`)	`400`	Envie só `yyyy-MM-dd`
`currency` fora do formato ISO 4217	`400` com `errorCode` `CURRENCY_INVALID`	Use `BRL`, `USD`…
Chave `org_` com `accountId` de outra Organization	`404` com `errorCode` `ACCOUNT_NOT_FOUND`	Confira o `accountId`

Exemplo de 400:

{
  "statusCode": 400,
  "message": "Validation failed",
  "errors": [
    {
      "propertyName": "To",
      "message": "O intervalo pode ter no máximo 92 dias.",
      "errorCode": "STATEMENT_RANGE_INVALID"
    }
  ]
}

Decida pelo errorCode, não pelo texto de message, que pode mudar.

Tipos de mensagem

`type`	Tipo de mensagem
`meta-marketing`	Marketing
`meta-utility`	Utilidade
`meta-authentication`	Autenticação
`meta-service`	Atendimento
`meta-free`	Gratuita
`inbound`	Mensagem recebida

Início

Contas

API Keys

Canais

WhatsApp Oficial

Cobranças

Tipos de Mensagem

Operações de Mensagem

Sessão e Conexão

Consultas

Interação

Consumo diário

Consumo diário

Parâmetros

Exemplos de período

Como o dia é contado

Resposta

Campos da resposta

Estornos e ajustes

Erros mais comuns

Tipos de mensagem

​Consumo diário

​Parâmetros

​Exemplos de período

​Como o dia é contado

​Resposta

​Campos da resposta

​Estornos e ajustes

​Erros mais comuns

​Tipos de mensagem

Consumo diário

Parâmetros

Exemplos de período

Como o dia é contado

Resposta

Campos da resposta

Estornos e ajustes

Erros mais comuns

Tipos de mensagem