---
title: "Estima custo por quantidade de destinatários"
method: GET
path: "/v1/campaigns/estimate"
tags: ["campaigns"]
---

# Estima custo por quantidade de destinatários

`GET /v1/campaigns/estimate`

Usa o preço de referência do mercado local. Para campanha com números
de vários países, use o `POST`. `templateName` aceita nome ou ID.
Permissão: `READ`.

## Query parameters

- `templateName` string, required
- `count` integer, required

## Response `200`

Estimativa

- CampaignEstimateResponse
  - `templateCategory` string, required
  - `recipientCount` integer, required
  - `templateCost` number, required — Custo Meta total, em reais.
  - `araraFee` number, required — Taxa Arara total, em reais.
  - `unitPrice` number, required — Preço médio por mensagem.
  - `totalCost` number, required
  - `markets` CampaignMarketCost[] — Quebra por mercado. Vazio no `GET`.
    - `market` string
    - `count` integer
    - `unitPrice` number
    - `metaCostUnit` number
    - `subtotal` number

## Other responses

- `401` — Chave inválida, revogada, expirada ou IP fora da allowlist.
- `403` — Sem `Authorization` ou chave fora do escopo: corpo `SpringError`. Regra de negócio: corpo `Error` com `PLAN_FEATURE_LOCKED`, `PLAN_LIMIT_REACHED`, `ACCOUNT_NOT_ACTIVATED`, `NO_DEDICATED_NUMBER`, `ORGANIZATION_SUSPENDED`, `NUMBER_BLOCKED`, `FRAUD_SUSPECTED`, `RESOURCE_FORBIDDEN`, `VIEWER_READ_ONLY`.
- `422` — Regra de negócio: `RECIPIENT_OPTED_OUT`, `INVALID_RECIPIENT`, `TEMPLATE_PAUSED`, `TEMPLATE_NOT_SENDABLE`, `TEMPLATE_VARIABLES_MISMATCH`, `CONVERSATION_WINDOW_CLOSED`, `SENDER_NOT_ALLOWED`, `UNPROCESSABLE_ENTITY` ou um código de diagnóstico `ararahq-*` com `details.diagnostic`.

## Changes

- **2026-09-15** `372d8c2e735d` — 8 breaking, 2 warning, 11 info
  - the response property `error` became optional for the status `401`
  - the `araraFee` response's property format changed from `float` to no format for status `200`
  - the `error` response's property type changed from `object` to `string` for status `401`
  - the `templateCost` response's property format changed from `float` to no format for status `200`
  - …17 more
- **2026-05-25** `4e426b85f784` — 4 breaking, 4 warning, 11 info
  - the `araraFee` response's property format changed from `decimal` to `float` for status `200`
  - the `templateCost` response's property format changed from `decimal` to `float` for status `200`
  - the `totalCost` response's property format changed from `decimal` to `float` for status `200`
  - the `unitPrice` response's property format changed from `decimal` to `float` for status `200`
  - …15 more

[Change history](https://skmtc.dev/ararahq/apis/ararahq-api/changes/v1/campaigns/estimate/get.md)

---

[API](https://skmtc.dev/ararahq/apis/ararahq-api.md) · [All operations](https://skmtc.dev/ararahq/apis/ararahq-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ararahq/apis/ararahq-api/revisions/372d8c2e735d?raw)