Get a Price Quote

Price a campaign before you build it with the flyer-distribution and EDDM calculators, or estimate a draft with the per-campaign cost endpoints.

There are two ways to price work with Oppizi:

Calculators — standalone quotes for a hypothetical campaign ("what would 5,000 postcards cost?"), before any draft exists.
Per-campaign cost — the estimate for a draft you're actually assembling, before you submit it for review.

export OPPIZI_CLIENT_KEY="YOUR_CLIENT_KEY"
export API="https://developer-api.oppizi.com"

Calculators

Discover the options

The calculators are parameterised by your account's available options and quantity tiers. Read them first:

curl "$API/client/calculators/flyer-distribution/options" \
  -H "Authorization: Bearer $OPPIZI_CLIENT_KEY"

curl "$API/client/calculators/flyer-distribution/quantities" \
  -H "Authorization: Bearer $OPPIZI_CLIENT_KEY"

Flyer-distribution quote

curl -X POST "$API/client/calculators/flyer-distribution" \
  -H "Authorization: Bearer $OPPIZI_CLIENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "cityId": "cty_310",
    "quantity": 5000,
    "format": "POSTCARD_6x9"
  }'

{
  "success": true,
  "data": {
    "quantity": 5000,
    "currency": "USD",
    "total": 3450,
    "unitPrice": 0.69
  }
}

EDDM quote

curl -X POST "$API/client/calculators/eddm" \
  -H "Authorization: Bearer $OPPIZI_CLIENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "cityId": "cty_310",
    "carrierRoutes": ["C001", "C002"],
    "format": "POSTCARD_6x9"
  }'

The EDDM calculator prices the households on the carrier routes you pass.

Per-campaign cost

Once you have a draft, price it directly. cost returns the current committed estimate; cost-preview recomputes it for hypothetical changes without saving.

# Estimate for the draft as it stands
curl "$API/client/campaigns/cmp_9f21/cost" \
  -H "Authorization: Bearer $OPPIZI_CLIENT_KEY"

# Preview a change (e.g. a different quantity or format) before applying it
curl -X POST "$API/client/campaigns/cmp_9f21/cost-preview" \
  -H "Authorization: Bearer $OPPIZI_CLIENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "quantity": 7500 }'

A quote is an estimate. Nothing is charged until the campaign clears In Review — see Create an ADM campaign.

Via MCP

Just ask your connected assistant:

"What would 5,000 postcards to my customer list cost?"

"How much would EDDM across my two downtown carrier routes run?"

The assistant calls the right calculator (or the draft's cost endpoint) and reads back the total. See Connect Claude or ChatGPT.

Next steps

Create an ADM campaign or run an EDDM campaign.
Read performance & ROI once a campaign is live.