---
title: "Set banner country pricing"
type: reference
method: POST
path: /rest-api/banner/{bannerId}/pricing/{countryCode}.do
tag: "Banners"
---

# Set banner country pricing

`POST https://YOUR-NETWORK-DOMAIN/rest-api/banner/{bannerId}/pricing/{countryCode}.do`

Creates or updates a country-specific price override for the specified banner. The banner must already have a base pricing record configured. The country code must be a valid ISO 3166 two-letter code; it is case-insensitive (us and US are the same row), and Great Britain is stored and read back as UK, GB being accepted for it. price is required and must be between 0 and 1000000; a missing or out-of-range price is answered with a 400 naming it and nothing is written. On a CPA banner, actionId prices one conversion action in that country (an action the caller can see in the console's action list); without it the price is for every action. On any other pricing type actionId does not apply and is listed in ignoredFields. Requires UPDATE permission and MANAGE_PRICING permission.

## Path params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `bannerId` | integer | yes | `3001` | ID of the banner to set country pricing for |
| `countryCode` | string | yes | `US` | ISO 3166 two-letter country code (e.g., US, GB) |

## Form params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `price` | number | yes | `1.75` | Price for the country, 0 to 1000000 |
| `actionId` | integer | no | `42` | CPA banners only: the conversion action this country price is for; omit to price every action |

## Responses

- `200` — Country pricing updated
- `400` — Missing or out-of-range price, unknown country, or no base pricing yet
- `401` — Authentication error
- `403` — Not enough permissions
- `404` — Banner not found, or actionId names no action the caller can see

## Example request

```bash
curl --request POST \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/banner/3001/pricing/US.do' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'price=1.75' \
  --data-urlencode 'actionId=42'
```

Source: https://epom.com/ad-server/docs/api/banners/post-banner-pricing-by-banner-id