Skip to main content
cURL
Cost: Free.
The country is served as List countries serves it, and expand works the same way: currency, fees (today’s schedule) and shipping_carriers, free, each null with a notice when Alura can’t give it. The code is ISO 3166-1 alpha-2, in any letter case. A code that isn’t an assigned ISO code answers 400, including Etsy’s legacy codes AN, CS and KV.
The expanded currency.payout_currency is about the currency: whether Etsy deposits sales in it. The country’s payout_currency_code is the currency Etsy pays sellers based in this country.

Authorizations

​
Authorization
string
header
required

An API key: Authorization: Bearer alura_sk_....

Path Parameters

​
code
string
required

ISO 3166-1 alpha-2 code, for example FR; any case. Etsy's legacy codes AN, CS and KV are not ISO codes and answer 400.

Pattern: ^[A-Za-z]{2}$
Example:

"FR"

Query Parameters

​
fields
string

Comma-separated dotted paths to return; id, object and as_of always come back.

​
expand
string

Comma-separated related objects to include: currency, fees, shipping_carriers. Free.

Example:

"currency,fees,shipping_carriers"

Response

OK

​
object
string
required
Allowed value: "country"
​
code
string
required

ISO 3166-1 alpha-2 code, upper case.

​
name
string
required

ISO 3166's English short name, the standard's name rather than a display name (United Kingdom of Great Britain and Northern Ireland, Korea, Republic of).

​
currency_code
string | null
required

The country's currency, ISO 4217 (EUR). null where ISO 4217 names no currency (Antarctica, South Georgia and the South Sandwich Islands, Palestine), with a currency_unknown notice.

​
payout_currency_code
string | null
required

The currency Etsy pays sellers in, for a seller whose bank account is in this country (ISO 4217); USD for Payoneer countries (JP), EUR in Bulgaria, Croatia, the Czech Republic, Hungary, Poland and Romania. null exactly where Etsy Payments is not available.

​
etsy_payments
boolean | null
required

A shop can sell here with Etsy Payments ("Countries Eligible for Etsy Payments", which Etsy calls complete; a shop opens only in one of them). The US territories are true. null where Etsy doesn't say.

​
valid_from
string<date> | null
required

The day these facts took effect (Bulgaria: the euro, 2026-01-01); null when they held before Alura's recorded history (2025-10-22).

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
​
sources
object[]
required

Etsy's Countries Eligible for Etsy Payments page, and a second Etsy page only for what it doesn't say: the bank-account and euro deposit rules, Payoneer's USD deposits or India's limits. name and currency_code follow ISO 3166 and ISO 4217, as their descriptions say.

​
notices
object[]
required

What limits selling from the country, and why a part is unknown or not inlined; empty when nothing is.

​
currency
object | null

With expand=currency: GET /v1/etsy/currencies/{currency_code}, with its USD rate and rate_as_of (its boolean payout_currency is the currency's, not this country's payout_currency_code). null when it is not an Etsy Payments currency (currency_unsupported) or there is none.

​
fees
object

With expand=fees: GET /v1/etsy/fees?seller_country={code} for today (UTC), with its own as_of, recorded_from and notices (etsy_payments_unavailable where Etsy Payments is not available).

​
shipping_carriers
object | null

With expand=shipping_carriers: GET /v1/etsy/shipping-carriers?origin_country={code}, with its fetched_at. Alura stores them for the countries connected shops ship from; elsewhere null with a shipping_carriers_unknown notice, never an empty list.