Relatório da campanha

Resultado de uma campanha: o funil em números absolutos, as taxas — cada uma acompanhada do denominador que usou — e a série diária do próprio envio.

GET /v1/campaigns/{campaignId}/report

Exemplo de requisição

curl -X GET "https://app.madmail.com.br/api/v1/campaigns/{campaignId}/report" \
  -H "Authorization: Bearer us_SUA_CHAVE"

Parâmetros

Nome	Local	Obrigatório	Tipo	Descrição
`campaignId`	path	Sim	string

Respostas

200 — Relatório completo da campanha: funil absoluto, percentuais com base explícita e série temporal do próprio envio.

Campo	Tipo	Descrição
`campaign`	object
`isPartial`	boolean	true enquanto a campanha não terminou (DRAFT, SCHEDULED, RUNNING, PAUSED). Os números são parciais, não finais.
`hasSendingStarted`	boolean	false quando nada saiu ainda: totais em 0 e todas as taxas em null.
`totals`	object
`rates`	object
`timeSeries`	array<object>

Exemplo de resposta

{
  "campaign": {
    "id": "abc123",
    "name": "Exemplo",
    "subject": "Assunto do e-mail",
    "status": "DRAFT",
    "scheduledAt": "string",
    "sendingStartedAt": "string",
    "sendingEndedAt": "string",
    "audienceSize": 1,
    "createdAt": "string",
    "updatedAt": "string"
  },
  "isPartial": true,
  "hasSendingStarted": true,
  "totals": {
    "audienceSize": 1,
    "sent": 1,
    "delivered": 1,
    "opened": 1,
    "clicked": 1,
    "unsubscribed": 1,
    "bounced": 1,
    "hardBounced": 1,
    "softBounced": 1,
    "complained": 1
  },
  "rates": {
    "deliveryRate": {
      "value": 1,
      "base": "delivered",
      "baseCount": 1
    },
    "openRate": {
      "value": 1,
      "base": "delivered",
      "baseCount": 1
    },
    "clickRate": {
      "value": 1,
      "base": "delivered",
      "baseCount": 1
    },
    "clickToOpenRate": {
      "value": 1,
      "base": "delivered",
      "baseCount": 1
    },
    "unsubscribeRate": {
      "value": 1,
      "base": "delivered",
      "baseCount": 1
    },
    "bounceRate": {
      "value": 1,
      "base": "delivered",
      "baseCount": 1
    },
    "hardBounceRate": {
      "value": 1,
      "base": "delivered",
      "baseCount": 1
    },
    "softBounceRate": {
      "value": 1,
      "base": "delivered",
      "baseCount": 1
    },
    "complaintRate": {
      "value": 1,
      "base": "delivered",
      "baseCount": 1
    },
    "progressRate": {
      "value": 1,
      "base": "delivered",
      "baseCount": 1
    }
  },
  "timeSeries": [
    {
      "date": "2026-08-17",
      "sent": 1,
      "delivered": 1,
      "opened": 1,
      "clicked": 1,
      "bounced": 1,
      "complained": 1
    }
  ]
}