# Countries

> A Country represents a market your catalog sells in, used to scope prices and offers.

A **Country** represents a market your catalog operates in. Each country has a `code` (the [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) code such as `FR` or `US`) and a translatable `name`. Countries are a reference resource you set up once, then point your offers at.

Countries are one of the dimensions used to **resolve prices**: a [Sale offer](/api/product-management/sale-offers/) or [Purchase offer](/api/product-management/purchase-offers/) applies to a specific country, and you pass `resolveContext[country]` when reading a [Variant](/api/product-management/variants/) to get the price for that market.

## The Country object

## Common workflows

- **Set up a market.** Create a country with its ISO `code`, then attach [Sale offers](/api/product-management/sale-offers/) and [Purchase offers](/api/product-management/purchase-offers/) that apply there.
- **Resolve country-specific prices.** Pass `resolveContext[country]` (with `resolveContext[channel]` and `resolveContext[at]`) when reading [Variants](/api/product-management/variants/) so each variant's `resolvedPrice` reflects that market.
- **Localize names.** Read or write the translatable `name` per locale with the `X-Flowkiwi-Locale` header.

## Conventions

### Authentication and headers

All requests require an OAuth 2.0 bearer token and the organization scope header:

```
Authorization: Bearer <token>
X-Flowkiwi-Organization-Id: <organization-id>
```

For the translatable `name`, set the active locale (and optionally a fallback):

```
X-Flowkiwi-Locale: fr-FR
X-Flowkiwi-Locale-Fallback: en-US
```

### Partial updates

`PATCH` uses [JSON Merge Patch](https://datatracker.ietf.org/doc/html/rfc7396) with `Content-Type: application/merge-patch+json`.