---
title: "Update placement country pricing"
type: reference
method: POST
path: /rest-api/placements/{placementId}/pricing/{countryCode}.do
tag: "Placements"
---

# Update placement country pricing

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

Creates or updates a country-specific price override for the given placement's fixed pricing model. The country is identified by its ISO 3166 two-letter code. If a country pricing entry already exists for the given country and action combination, its price is updated; otherwise a new entry is created. The code is case-insensitive (us and US are the same row); Great Britain is stored and read back as UK, and GB is accepted for it. price must be between 0 and 1000000, or the call is a 400 naming it and nothing is written. An actionId must name a live action the caller can see in the console's action list. Requires ENABLED level on the SITE_PAYMENT_MODEL permission.

## Path params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `placementId` | integer | yes | `4001` | Unique numeric ID of the placement |
| `countryCode` | string | yes | `US` | ISO 3166 two-letter country code (e.g., US, GB, DE) |

## Form params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `price` | number | yes | `2.50` | Price value for the specified country as a decimal number |
| `actionId` | integer | no | `42` | Optional action ID for CPA pricing; null for CPM/CPC |

## Responses

- `200` — Country pricing updated successfully
- `400` — Bad request
- `401` — Authentication error
- `403` — Permission denied
- `404` — actionId names no action the caller can see

## Example request

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

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