cURL
curl "https://api.alura.io/v1/etsy/countries" \
-H "Authorization: Bearer $ALURA_API_KEY"const res = await fetch('https://api.alura.io/v1/etsy/countries', {
headers: {
Authorization: `Bearer ${process.env.ALURA_API_KEY}`,
},
});
console.log(await res.json());import json
import os
import urllib.request
request = urllib.request.Request(
"https://api.alura.io/v1/etsy/countries",
headers={
"Authorization": f"Bearer {os.environ['ALURA_API_KEY']}",
},
)
with urllib.request.urlopen(request) as response:
print(json.load(response)){
"object": "list",
"data": [
{
"object": "country",
"code": "AQ",
"name": "Antarctica",
"currency_code": null,
"payout_currency_code": null,
"etsy_payments": false,
"valid_from": null,
"sources": [
{
"url": "https://help.etsy.com/hc/en-us/articles/115015710408",
"title": "Countries Eligible for Etsy Payments",
"publisher": "Etsy",
"published_at": "2026-04-14",
"read_at": "2026-10-22"
}
],
"notices": [
{
"code": "currency_unknown",
"detail": "ISO 4217 names no universal currency for this country, so `currency_code` is null."
}
]
},
{
"object": "country",
"code": "BG",
"name": "Bulgaria",
"currency_code": "EUR",
"payout_currency_code": "EUR",
"etsy_payments": true,
"valid_from": "2026-01-01",
"sources": [
{
"url": "https://help.etsy.com/hc/en-us/articles/115015710408",
"title": "Countries Eligible for Etsy Payments",
"publisher": "Etsy",
"published_at": "2026-04-14",
"read_at": "2026-10-22"
},
{
"url": "https://help.etsy.com/hc/en-us/articles/360000337767",
"title": "Currencies Supported for Etsy Payments",
"publisher": "Etsy",
"published_at": "2026-06-16",
"read_at": "2026-10-22"
}
],
"notices": []
},
{
"object": "country",
"code": "CN",
"name": "China",
"currency_code": "CNY",
"payout_currency_code": "USD",
"etsy_payments": true,
"valid_from": null,
"sources": [
{
"url": "https://help.etsy.com/hc/en-us/articles/115015710408",
"title": "Countries Eligible for Etsy Payments",
"publisher": "Etsy",
"published_at": "2026-04-14",
"read_at": "2026-10-22"
},
{
"url": "https://help.etsy.com/hc/en-us/articles/16999319005207",
"title": "How Do I Use a Payoneer Account With Etsy Payments?",
"publisher": "Etsy",
"published_at": "2026-04-22",
"read_at": "2026-10-22"
}
],
"notices": [
{
"code": "new_shops_unavailable",
"detail": "Etsy says new shops cannot open in China."
}
]
},
{
"object": "country",
"code": "FR",
"name": "France",
"currency_code": "EUR",
"payout_currency_code": "EUR",
"etsy_payments": true,
"valid_from": null,
"sources": [
{
"url": "https://help.etsy.com/hc/en-us/articles/115015710408",
"title": "Countries Eligible for Etsy Payments",
"publisher": "Etsy",
"published_at": "2026-04-14",
"read_at": "2026-10-22"
}
],
"notices": []
},
{
"object": "country",
"code": "IN",
"name": "India",
"currency_code": "INR",
"payout_currency_code": "USD",
"etsy_payments": true,
"valid_from": null,
"sources": [
{
"url": "https://help.etsy.com/hc/en-us/articles/115015710408",
"title": "Countries Eligible for Etsy Payments",
"publisher": "Etsy",
"published_at": "2026-04-14",
"read_at": "2026-10-22"
},
{
"url": "https://help.etsy.com/hc/en-us/articles/6742925359255",
"title": "How to Accept Payments as a Seller in India",
"publisher": "Etsy",
"published_at": "2025-05-28",
"read_at": "2026-10-22"
}
],
"notices": [
{
"code": "international_sales_only",
"detail": "Etsy says new shops opened in India can only sell internationally."
}
]
},
{
"object": "country",
"code": "JP",
"name": "Japan",
"currency_code": "JPY",
"payout_currency_code": "USD",
"etsy_payments": true,
"valid_from": null,
"sources": [
{
"url": "https://help.etsy.com/hc/en-us/articles/115015710408",
"title": "Countries Eligible for Etsy Payments",
"publisher": "Etsy",
"published_at": "2026-04-14",
"read_at": "2026-10-22"
},
{
"url": "https://help.etsy.com/hc/en-us/articles/16999319005207",
"title": "How Do I Use a Payoneer Account With Etsy Payments?",
"publisher": "Etsy",
"published_at": "2026-04-22",
"read_at": "2026-10-22"
}
],
"notices": []
},
{
"object": "country",
"code": "NE",
"name": "Niger",
"currency_code": "XOF",
"payout_currency_code": null,
"etsy_payments": false,
"valid_from": null,
"sources": [
{
"url": "https://help.etsy.com/hc/en-us/articles/115015710408",
"title": "Countries Eligible for Etsy Payments",
"publisher": "Etsy",
"published_at": "2026-04-14",
"read_at": "2026-10-22"
}
],
"notices": []
},
{
"object": "country",
"code": "PL",
"name": "Poland",
"currency_code": "PLN",
"payout_currency_code": "EUR",
"etsy_payments": true,
"valid_from": null,
"sources": [
{
"url": "https://help.etsy.com/hc/en-us/articles/115015710408",
"title": "Countries Eligible for Etsy Payments",
"publisher": "Etsy",
"published_at": "2026-04-14",
"read_at": "2026-10-22"
},
{
"url": "https://help.etsy.com/hc/en-us/articles/360000337767",
"title": "Currencies Supported for Etsy Payments",
"publisher": "Etsy",
"published_at": "2026-06-16",
"read_at": "2026-10-22"
}
],
"notices": []
},
{
"object": "country",
"code": "PR",
"name": "Puerto Rico",
"currency_code": "USD",
"payout_currency_code": "USD",
"etsy_payments": true,
"valid_from": null,
"sources": [
{
"url": "https://help.etsy.com/hc/en-us/articles/115015710408",
"title": "Countries Eligible for Etsy Payments",
"publisher": "Etsy",
"published_at": "2026-04-14",
"read_at": "2026-10-22"
},
{
"url": "https://help.etsy.com/hc/en-us/articles/360000337767",
"title": "Currencies Supported for Etsy Payments",
"publisher": "Etsy",
"published_at": "2026-06-16",
"read_at": "2026-10-22"
}
],
"notices": []
},
{
"object": "country",
"code": "US",
"name": "United States of America",
"currency_code": "USD",
"payout_currency_code": "USD",
"etsy_payments": true,
"valid_from": null,
"sources": [
{
"url": "https://help.etsy.com/hc/en-us/articles/115015710408",
"title": "Countries Eligible for Etsy Payments",
"publisher": "Etsy",
"published_at": "2026-04-14",
"read_at": "2026-10-22"
},
{
"url": "https://help.etsy.com/hc/en-us/articles/360000337767",
"title": "Currencies Supported for Etsy Payments",
"publisher": "Etsy",
"published_at": "2026-06-16",
"read_at": "2026-10-22"
}
],
"notices": []
}
],
"has_more": false,
"next_cursor": null,
"total": {
"value": 10,
"relation": "eq"
}
}{
"type": "https://docs.alura.io/errors/invalid_request",
"title": "Invalid request",
"status": 400,
"code": "invalid_request",
"detail": "Invalid request",
"suggestion": "Fix the request as the detail says, then send it again.",
"retryable": false,
"request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}{
"type": "https://docs.alura.io/errors/unauthorized",
"title": "Unauthorized",
"status": 401,
"code": "unauthorized",
"detail": "Unauthorized",
"suggestion": "Send a valid API key as `Authorization: Bearer alura_sk_...`.",
"retryable": false,
"request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}{
"type": "https://docs.alura.io/errors/credits_exhausted",
"title": "API credits exhausted",
"status": 402,
"code": "credits_exhausted",
"detail": "API credits exhausted",
"suggestion": "Upgrade the plan or wait for the monthly reset.",
"retryable": false,
"request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}{
"type": "https://docs.alura.io/errors/plan_required",
"title": "Plan required",
"status": 403,
"code": "plan_required",
"detail": "Plan required",
"suggestion": "Upgrade the workspace plan to use this operation.",
"retryable": false,
"request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}{
"type": "https://docs.alura.io/errors/not_found",
"title": "Not found",
"status": 404,
"code": "not_found",
"detail": "Not found",
"suggestion": "Check the ID, or search for it first.",
"retryable": false,
"request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}{
"type": "https://docs.alura.io/errors/method_not_allowed",
"title": "Method not allowed",
"status": 405,
"code": "method_not_allowed",
"detail": "Method not allowed",
"suggestion": "Use one of the methods in the Allow header.",
"retryable": false,
"request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}{
"type": "https://docs.alura.io/errors/rate_limited",
"title": "Rate limited",
"status": 429,
"code": "rate_limited",
"detail": "Rate limited",
"suggestion": "Wait for Retry-After, then retry.",
"retryable": true,
"request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}{
"type": "https://docs.alura.io/errors/internal_error",
"title": "Internal error",
"status": 500,
"code": "internal_error",
"detail": "Internal error",
"suggestion": "Retry; if it keeps failing, report the request_id.",
"retryable": true,
"request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}{
"type": "https://docs.alura.io/errors/credits_unavailable",
"title": "API credits unavailable",
"status": 503,
"code": "credits_unavailable",
"detail": "API credits unavailable",
"suggestion": "Retry shortly.",
"retryable": true,
"request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}Countries & currencies
List countries
List every country with its currency, whether a shop there can sell with Etsy Payments and the currency Etsy pays its sellers in.
cURL
curl "https://api.alura.io/v1/etsy/countries" \
-H "Authorization: Bearer $ALURA_API_KEY"const res = await fetch('https://api.alura.io/v1/etsy/countries', {
headers: {
Authorization: `Bearer ${process.env.ALURA_API_KEY}`,
},
});
console.log(await res.json());import json
import os
import urllib.request
request = urllib.request.Request(
"https://api.alura.io/v1/etsy/countries",
headers={
"Authorization": f"Bearer {os.environ['ALURA_API_KEY']}",
},
)
with urllib.request.urlopen(request) as response:
print(json.load(response)){
"object": "list",
"data": [
{
"object": "country",
"code": "AQ",
"name": "Antarctica",
"currency_code": null,
"payout_currency_code": null,
"etsy_payments": false,
"valid_from": null,
"sources": [
{
"url": "https://help.etsy.com/hc/en-us/articles/115015710408",
"title": "Countries Eligible for Etsy Payments",
"publisher": "Etsy",
"published_at": "2026-04-14",
"read_at": "2026-10-22"
}
],
"notices": [
{
"code": "currency_unknown",
"detail": "ISO 4217 names no universal currency for this country, so `currency_code` is null."
}
]
},
{
"object": "country",
"code": "BG",
"name": "Bulgaria",
"currency_code": "EUR",
"payout_currency_code": "EUR",
"etsy_payments": true,
"valid_from": "2026-01-01",
"sources": [
{
"url": "https://help.etsy.com/hc/en-us/articles/115015710408",
"title": "Countries Eligible for Etsy Payments",
"publisher": "Etsy",
"published_at": "2026-04-14",
"read_at": "2026-10-22"
},
{
"url": "https://help.etsy.com/hc/en-us/articles/360000337767",
"title": "Currencies Supported for Etsy Payments",
"publisher": "Etsy",
"published_at": "2026-06-16",
"read_at": "2026-10-22"
}
],
"notices": []
},
{
"object": "country",
"code": "CN",
"name": "China",
"currency_code": "CNY",
"payout_currency_code": "USD",
"etsy_payments": true,
"valid_from": null,
"sources": [
{
"url": "https://help.etsy.com/hc/en-us/articles/115015710408",
"title": "Countries Eligible for Etsy Payments",
"publisher": "Etsy",
"published_at": "2026-04-14",
"read_at": "2026-10-22"
},
{
"url": "https://help.etsy.com/hc/en-us/articles/16999319005207",
"title": "How Do I Use a Payoneer Account With Etsy Payments?",
"publisher": "Etsy",
"published_at": "2026-04-22",
"read_at": "2026-10-22"
}
],
"notices": [
{
"code": "new_shops_unavailable",
"detail": "Etsy says new shops cannot open in China."
}
]
},
{
"object": "country",
"code": "FR",
"name": "France",
"currency_code": "EUR",
"payout_currency_code": "EUR",
"etsy_payments": true,
"valid_from": null,
"sources": [
{
"url": "https://help.etsy.com/hc/en-us/articles/115015710408",
"title": "Countries Eligible for Etsy Payments",
"publisher": "Etsy",
"published_at": "2026-04-14",
"read_at": "2026-10-22"
}
],
"notices": []
},
{
"object": "country",
"code": "IN",
"name": "India",
"currency_code": "INR",
"payout_currency_code": "USD",
"etsy_payments": true,
"valid_from": null,
"sources": [
{
"url": "https://help.etsy.com/hc/en-us/articles/115015710408",
"title": "Countries Eligible for Etsy Payments",
"publisher": "Etsy",
"published_at": "2026-04-14",
"read_at": "2026-10-22"
},
{
"url": "https://help.etsy.com/hc/en-us/articles/6742925359255",
"title": "How to Accept Payments as a Seller in India",
"publisher": "Etsy",
"published_at": "2025-05-28",
"read_at": "2026-10-22"
}
],
"notices": [
{
"code": "international_sales_only",
"detail": "Etsy says new shops opened in India can only sell internationally."
}
]
},
{
"object": "country",
"code": "JP",
"name": "Japan",
"currency_code": "JPY",
"payout_currency_code": "USD",
"etsy_payments": true,
"valid_from": null,
"sources": [
{
"url": "https://help.etsy.com/hc/en-us/articles/115015710408",
"title": "Countries Eligible for Etsy Payments",
"publisher": "Etsy",
"published_at": "2026-04-14",
"read_at": "2026-10-22"
},
{
"url": "https://help.etsy.com/hc/en-us/articles/16999319005207",
"title": "How Do I Use a Payoneer Account With Etsy Payments?",
"publisher": "Etsy",
"published_at": "2026-04-22",
"read_at": "2026-10-22"
}
],
"notices": []
},
{
"object": "country",
"code": "NE",
"name": "Niger",
"currency_code": "XOF",
"payout_currency_code": null,
"etsy_payments": false,
"valid_from": null,
"sources": [
{
"url": "https://help.etsy.com/hc/en-us/articles/115015710408",
"title": "Countries Eligible for Etsy Payments",
"publisher": "Etsy",
"published_at": "2026-04-14",
"read_at": "2026-10-22"
}
],
"notices": []
},
{
"object": "country",
"code": "PL",
"name": "Poland",
"currency_code": "PLN",
"payout_currency_code": "EUR",
"etsy_payments": true,
"valid_from": null,
"sources": [
{
"url": "https://help.etsy.com/hc/en-us/articles/115015710408",
"title": "Countries Eligible for Etsy Payments",
"publisher": "Etsy",
"published_at": "2026-04-14",
"read_at": "2026-10-22"
},
{
"url": "https://help.etsy.com/hc/en-us/articles/360000337767",
"title": "Currencies Supported for Etsy Payments",
"publisher": "Etsy",
"published_at": "2026-06-16",
"read_at": "2026-10-22"
}
],
"notices": []
},
{
"object": "country",
"code": "PR",
"name": "Puerto Rico",
"currency_code": "USD",
"payout_currency_code": "USD",
"etsy_payments": true,
"valid_from": null,
"sources": [
{
"url": "https://help.etsy.com/hc/en-us/articles/115015710408",
"title": "Countries Eligible for Etsy Payments",
"publisher": "Etsy",
"published_at": "2026-04-14",
"read_at": "2026-10-22"
},
{
"url": "https://help.etsy.com/hc/en-us/articles/360000337767",
"title": "Currencies Supported for Etsy Payments",
"publisher": "Etsy",
"published_at": "2026-06-16",
"read_at": "2026-10-22"
}
],
"notices": []
},
{
"object": "country",
"code": "US",
"name": "United States of America",
"currency_code": "USD",
"payout_currency_code": "USD",
"etsy_payments": true,
"valid_from": null,
"sources": [
{
"url": "https://help.etsy.com/hc/en-us/articles/115015710408",
"title": "Countries Eligible for Etsy Payments",
"publisher": "Etsy",
"published_at": "2026-04-14",
"read_at": "2026-10-22"
},
{
"url": "https://help.etsy.com/hc/en-us/articles/360000337767",
"title": "Currencies Supported for Etsy Payments",
"publisher": "Etsy",
"published_at": "2026-06-16",
"read_at": "2026-10-22"
}
],
"notices": []
}
],
"has_more": false,
"next_cursor": null,
"total": {
"value": 10,
"relation": "eq"
}
}{
"type": "https://docs.alura.io/errors/invalid_request",
"title": "Invalid request",
"status": 400,
"code": "invalid_request",
"detail": "Invalid request",
"suggestion": "Fix the request as the detail says, then send it again.",
"retryable": false,
"request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}{
"type": "https://docs.alura.io/errors/unauthorized",
"title": "Unauthorized",
"status": 401,
"code": "unauthorized",
"detail": "Unauthorized",
"suggestion": "Send a valid API key as `Authorization: Bearer alura_sk_...`.",
"retryable": false,
"request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}{
"type": "https://docs.alura.io/errors/credits_exhausted",
"title": "API credits exhausted",
"status": 402,
"code": "credits_exhausted",
"detail": "API credits exhausted",
"suggestion": "Upgrade the plan or wait for the monthly reset.",
"retryable": false,
"request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}{
"type": "https://docs.alura.io/errors/plan_required",
"title": "Plan required",
"status": 403,
"code": "plan_required",
"detail": "Plan required",
"suggestion": "Upgrade the workspace plan to use this operation.",
"retryable": false,
"request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}{
"type": "https://docs.alura.io/errors/not_found",
"title": "Not found",
"status": 404,
"code": "not_found",
"detail": "Not found",
"suggestion": "Check the ID, or search for it first.",
"retryable": false,
"request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}{
"type": "https://docs.alura.io/errors/method_not_allowed",
"title": "Method not allowed",
"status": 405,
"code": "method_not_allowed",
"detail": "Method not allowed",
"suggestion": "Use one of the methods in the Allow header.",
"retryable": false,
"request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}{
"type": "https://docs.alura.io/errors/rate_limited",
"title": "Rate limited",
"status": 429,
"code": "rate_limited",
"detail": "Rate limited",
"suggestion": "Wait for Retry-After, then retry.",
"retryable": true,
"request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}{
"type": "https://docs.alura.io/errors/internal_error",
"title": "Internal error",
"status": 500,
"code": "internal_error",
"detail": "Internal error",
"suggestion": "Retry; if it keeps failing, report the request_id.",
"retryable": true,
"request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}{
"type": "https://docs.alura.io/errors/credits_unavailable",
"title": "API credits unavailable",
"status": 503,
"code": "credits_unavailable",
"detail": "API credits unavailable",
"suggestion": "Retry shortly.",
"retryable": true,
"request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}Cost: Free.
Every ISO 3166-1 country comes in code order, with the source of each fact in
A part Alura can’t give is
New codes may be added.
For one country, use Get country.
curl -G "https://api.alura.io/v1/etsy/countries" \
-H "Authorization: Bearer $ALURA_API_KEY" \
--data-urlencode "limit=100" \
--data-urlencode "expand=currency"
sources. etsy_payments comes from Etsy’s list of eligible countries, which Etsy calls complete.
nameis the ISO 3166 name, not a display name:Korea, Republic of.payout_currency_codeis the currency Etsy pays a seller whose bank account is in the country: USD for Payoneer countries such asJP. It isnullexactly where Etsy Payments isn’t available.currency_codeisnullwhere ISO 4217 names no currency (such as Antarctica and Palestine), with acurrency_unknownnotice.
Add related data
expand inlines related objects for free, each with its own dates and notices:
expand | Adds | Same as |
|---|---|---|
currency | The country’s currency with its USD rate | Get currency |
fees | Today’s fee schedule for a seller based there | Get fees with seller_country |
shipping_carriers | The carriers for parcels sent from there | Get shipping carriers |
null with a notice, never an empty list or a zero.
Notices
Notices
code | Meaning |
|---|---|
new_shops_unavailable | Etsy says new shops can’t open there (China). |
international_sales_only | Etsy says shops there sell internationally only (India). |
currency_unknown | ISO 4217 names no currency for the country. |
currency_unsupported | With expand=currency: the country’s currency isn’t an Etsy Payments currency, so currency is null. |
shipping_carriers_unknown | With expand=shipping_carriers: Alura has no readable carriers stored for the country, so shipping_carriers is null. |
Authorizations
An API key: Authorization: Bearer alura_sk_....
Query Parameters
Page size: default 25, at most 100.
Required range:
1 <= x <= 100The next_cursor of the previous page. Bound to the query, the workspace and the key.
Comma-separated dotted paths to return; id, object and as_of always come back.
Comma-separated related objects to include: currency, fees, shipping_carriers. Free.