---
title: "Relatório de campanhas"
method: GET
path: "/v4/reports/campaign/{campaign_id}"
tags: ["conversas-v2-reports"]
---

# Relatório de campanhas

`GET /v4/reports/campaign/{campaign_id}`

## Request

- Base URL: `https://api.tallos.com.br`
- URL: `https://api.tallos.com.br/v4/reports/campaign/{campaign_id}`
- Auth: HTTP bearer

ℹ️ Este recurso está disponível na versão v4 da API.

Consulta o relatório paginado de uma campanha de broadcast (um registro por destinatário processado).

## Path parameters

- `campaign_id` string, hash, required

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

Relatório paginado da campanha

- CampaignReportResponse
  - `docs` CampaignReportRecipient[], required
    - `id` string, required
    - `campaign_id` string, required
    - `contact_id` string, required
    - `contact_name` string, required
    - `contact_phone` string, required
    - `channel` string, nullable
    - `integration` string, nullable
    - `message_type` string, nullable
    - `message_id` string, nullable
    - `template_id` string, nullable
    - `status` 'sent' | 'delivered' | 'read' | 'failed' | 'skipped' | 'processing' | 'unknown', required
    - `error_code` union
      - string
      - number
    - `error_reason` string, nullable
    - `processed_at` string, date-time, nullable
    - `clicks` CampaignReportClick[], required
      - `url` string, required
      - `button` CampaignReportClickButton
        - `label` string, nullable
        - `position` integer, nullable
  - `buttons` CampaignReportButton[], required
    - `position` integer, required
    - `label` string, nullable
    - `url` string, nullable
  - `total` integer, required
  - `limit` integer, required
  - `page` integer, required
  - `pages` integer, required

## Other responses

- `400`: Bad request
- `401`: Access Token missing or invalid
- `403`: Not authorized to access such resource
- `404`: Resource not found
- `422`: Unprocessable Content
- `500`: Internal Server Error

---

[API](https://skmtc.dev/rdstation/apis/rd-station-conversas-api-v2.md) - [All operations](https://skmtc.dev/rdstation/apis/rd-station-conversas-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/rdstation/apis/rd-station-conversas-api-v2/revisions/730a895096d0?raw)