> ## Documentation Index
> Fetch the complete documentation index at: https://developers.redo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# campaignCostEstimate

> What sending a campaign is estimated to cost, the way the campaign page in the Redo app shows it, from the store's billing prices and the campaign's recipients. Returns null if the caller owns no campaign with that id. An SMS campaign fails with CAMPAIGN_TEMPLATE_NOT_FOUND (409) when a template one of its variants uses was deleted, since the cost depends on the template's text. It counts the audience in the analytics warehouse, so it can take up to a minute and costs 30 points. A request may ask for at most 2 different campaigns.

**Required scopes:** [`campaigns_read`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-campaigns_read)

**Store must have one of:** `EMAIL_SMS`

## Arguments

**id** `ID!` *required*

The campaign's `id`, or its `legacyId` from an earlier version of the Redo API.

## Returns

**campaignCostEstimate** `[CampaignCostEstimate](/docs/api-reference/v3/reference/marketing/campaign-cost-estimate)`

What sending a campaign is estimated to cost, as the campaign page in the Redo app shows it. Costs are in US dollars.

**fields**

**channel** `[MarketingChannel!](/docs/api-reference/v3/reference/marketing/marketing-channel)` *required*

The channel the campaign sends over.

**costPerThousand** `[Money](/docs/api-reference/v3/reference/common/money)`

What Redo charges for a thousand emails. Null for SMS campaigns and for stores with no email billing.

**fields**

**amount** `[Decimal!](/docs/api-reference/v3/reference/common/decimal)` *required*

The exact amount as a decimal string (e.g. "19.99").

**currency** `String!` *required*

ISO 4217 currency code (e.g. USD).

**recipientCount** `Int!` *required*

How many recipients the cost is for. A finished email campaign has its actual count. Every other campaign has an estimate for its included and excluded segments, and no segments means 0.

**recipientCountIsActual** `Boolean!` *required*

True when `recipientCount` is the number of recipients a finished email campaign has, false when it is an estimate.

**smsVariants** `[\[CampaignSmsVariantCostEstimate!\]!](/docs/api-reference/v3/reference/marketing/campaign-sms-variant-cost-estimate)` *required*

The cost of each SMS variant, in order. Empty for email campaigns, for SMS campaigns with no variants, and for stores with no SMS billing.

**fields**

**carrierFeePerPart** `[Money!](/docs/api-reference/v3/reference/common/money)` *required*

What the carrier charges for each part. Zero when the store's billing leaves carrier fees out.

**fields**

**amount** `[Decimal!](/docs/api-reference/v3/reference/common/decimal)` *required*

The exact amount as a decimal string (e.g. "19.99").

**currency** `String!` *required*

ISO 4217 currency code (e.g. USD).

**messageType** `[SmsMessageType!](/docs/api-reference/v3/reference/marketing/sms-message-type)` *required*

Whether the variant sends as an SMS or an MMS.

**partCount** `Int!` *required*

How many parts the text splits into. An MMS is always one part.

**position** `Int!` *required*

The variant's position in the campaign, from 0. It matches the `position` of the campaign's SMS variant.

**pricePerPart** `[Money!](/docs/api-reference/v3/reference/common/money)` *required*

What Redo charges for each part, from the store's billing window or its plan. Often under a cent, so the amount keeps the fraction.

**fields**

**amount** `[Decimal!](/docs/api-reference/v3/reference/common/decimal)` *required*

The exact amount as a decimal string (e.g. "19.99").

**currency** `String!` *required*

ISO 4217 currency code (e.g. USD).

**total** `[Money!](/docs/api-reference/v3/reference/common/money)` *required*

The estimated cost of this variant: parts times the price and carrier fee per part, times its share of the recipients.

**fields**

**amount** `[Decimal!](/docs/api-reference/v3/reference/common/decimal)` *required*

The exact amount as a decimal string (e.g. "19.99").

**currency** `String!` *required*

ISO 4217 currency code (e.g. USD).

**weight** `Float!` *required*

The share of the audience that gets this variant, from 0 to 1. The variants' weights add up to 1.

**total** `[Money](/docs/api-reference/v3/reference/common/money)`

The estimated cost of the whole send. For SMS it is the sum of the variants' totals, and 0 for a campaign with no variants. Null when the store has no billing set up for the channel.

**fields**

**amount** `[Decimal!](/docs/api-reference/v3/reference/common/decimal)` *required*

The exact amount as a decimal string (e.g. "19.99").

**currency** `String!` *required*

ISO 4217 currency code (e.g. USD).

## Example

```graphql theme={null}
query {
  campaignCostEstimate(id: "...") {
    channel
    recipientCount
    recipientCountIsActual
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.