---
title: "Estima custo exato pela lista de telefones"
method: POST
path: "/v1/campaigns/estimate"
tags: ["campaigns"]
---

# Estima custo exato pela lista de telefones

`POST /v1/campaigns/estimate`

Calcula o preço por país de destino e devolve a quebra em `markets`.
Não cria nada nem debita. Permissão: `CAMPAIGNS_SEND`.

## Request body

- CampaignEstimateRequest
  - `templateName` string, required
  - `phones` string[], 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` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/ararahq/apis/ararahq-api/changes/v1/campaigns/estimate/post.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)