GET
/countriesReturns a list of countries known to the Paddle platform, including the currency used for automatic price conversion and whether Paddle supports sales to customers there.
The response is not paginated.
Response (200)
dataarrayrequired
isorequired
Two-letter code for the country. Typically an ISO 3166-1 alpha-2 code, though Paddle uses a small number of codes that ISO doesn't currently assign.
Country code (supported)
Two-letter code for a country that Paddle supports sales to. Typically an ISO 3166-1 alpha-2 code, though Paddle uses a small number of codes that ISO doesn't currently assign.
Values
ADAndorraAEUnited Arab EmiratesAGAntigua and BarbudaAIAnguillaALAlbania
+ Show all values− Hide values
AMArmeniaAOAngolaARArgentinaASAmerican SamoaATAustriaAUAustraliaAWArubaAXÃ…land IslandsAZAzerbaijanBABosnia and HerzegovinaBBBarbadosBDBangladeshBEBelgiumBFBurkina FasoBGBulgariaBHBahrainBIBurundiBJBeninBLSaint BarthélemyBMBermudaBNBruneiBOBoliviaBQCaribbean Netherlands (Bonaire, Sint Eustatius, and Saba)BRBrazilBSBahamasBTBhutanBVBouvet IslandBWBotswanaBZBelizeCACanadaCCCocos IslandsCGRepublic of CongoCHSwitzerlandCICôte d'Ivoire (Ivory Coast)CKCook IslandsCLChileCMCameroonCNChinaCOColombiaCRCosta RicaCVCape VerdeCWCuraçaoCXChristmas IslandCYCyprusCZCzechia (Czech Republic)DEGermanyDJDjiboutiDKDenmarkDMDominicaDODominican RepublicDZAlgeriaECEcuadorEEEstoniaEGEgyptEHWestern SaharaEREritreaESSpainETEthiopiaFIFinlandFJFijiFKFalkland IslandsFMMicronesiaFOFaroe IslandsFRFranceGAGabonGBUnited KingdomGDGrenadaGEGeorgiaGFFrench GuianaGGGuernseyGHGhanaGIGibraltarGLGreenlandGMGambiaGNGuineaGPGuadeloupeGQEquatorial GuineaGRGreeceGSSouth Georgia and the South Sandwich IslandsGTGuatemalaGUGuamGWGuinea-BissauGYGuyanaHKHong KongHMHeard Island and McDonald IslandsHNHondurasHRCroatiaHUHungaryIDIndonesiaIEIrelandILIsraelIMIsle of ManINIndiaIOBritish Indian Ocean TerritoryIQIraqISIcelandITItalyJEJerseyJMJamaicaJOJordanJPJapanKEKenyaKGKyrgyzstanKHCambodiaKIKiribatiKMComorosKNSaint Kitts and NevisKRSouth KoreaKWKuwaitKYCayman IslandsKZKazakhstanLALao People's Democratic Republic (Laos)LBLebanonLCSaint LuciaLILiechtensteinLKSri LankaLRLiberiaLSLesothoLTLithuaniaLULuxembourgLVLatviaMAMoroccoMCMonacoMDMoldovaMEMontenegroMFSaint MartinMGMadagascarMHMarshall IslandsMKMacedoniaMNMongoliaMOMacaoMPNorthern Mariana IslandsMQMartiniqueMRMauritaniaMSMontserratMTMaltaMUMauritiusMVMaldivesMWMalawiMXMexicoMYMalaysiaMZMozambiqueNANamibiaNCNew CaledoniaNENigerNFNorfolk IslandNGNigeriaNLNetherlandsNONorwayNPNepalNRNauruNUNiueNZNew ZealandOMOmanPAPanamaPEPeruPFFrench PolynesiaPGPapua New GuineaPHPhilippinesPKPakistanPLPolandPMSaint Pierre and MiquelonPNPitcairnPRPuerto RicoPSPalestinian territoriesPTPortugalPWPalauPYParaguayQAQatarREReunionRORomaniaRSRepublic of SerbiaRWRwandaSASaudi ArabiaSBSolomon IslandsSCSeychellesSESwedenSGSingaporeSHSaint HelenaSISloveniaSJSvalbard and Jan MayenSKSlovakiaSLSierra LeoneSMSan MarinoSNSenegalSRSurinameSTSão Tomé and PrÃncipeSVEl SalvadorSXSint MaartenSZSwazilandTCTurks and Caicos IslandsTDChadTFFrench Southern and Antarctic LandsTGTogoTHThailandTJTajikistanTKTokelauTLTimor-LesteTMTurkmenistanTNTunisiaTOTongaTRTurkeyTTTrinidad and TobagoTVTuvaluTWTaiwanTZTanzaniaUAUkraineUGUgandaUMUnited States Minor Outlying IslandsUSUnited StatesUYUruguayUZUzbekistanVAHoly See (Vatican City)VCSaint Vincent and the GrenadinesVGBritish Virgin IslandsVIU.S. Virgin IslandsVNVietnamVUVanuatuWFWallis and FutunaWSSamoaXKKosovoYTMayotteZASouth AfricaZMZambia
Country code (unsupported)
Two-letter code for a country that Paddle doesn't support sales to. Typically an ISO 3166-1 alpha-2 code, though Paddle uses a small number of codes that ISO doesn't currently assign.
Values
AFAfghanistanAQAntarcticaANNetherlands Antilles. Withdrawn ISO 3166-1 code, succeeded by BQ, CW and SX.BYBelarusCDDemocratic Republic of Congo
+ Show all values− Hide values
CFCentral African RepublicCUCubaCSSerbia and Montenegro. Withdrawn ISO 3166-1 code, succeeded by RS and ME.HTHaitiIRIranKPNorth KoreaLYLibyaMLMaliMMMyanmar (Burma)NINicaraguaRURussiaSOSomaliaSSSouth SudanSDSudanSYSyriaVEVenezuelaYEYemenZWZimbabwe
iso3required
Three-letter code for the country. Typically an ISO 3166-1 alpha-3 code, though Paddle uses a small number of codes that ISO doesn't currently assign.
Country code (3-letter ISO, supported)
Three-letter code for a country that Paddle supports sales to. Typically an ISO 3166-1 alpha-3 code, though Paddle uses a small number of codes that ISO doesn't currently assign.
Values
ABWArubaAGOAngolaAIAAnguillaALAÃ…land IslandsALBAlbania
+ Show all values− Hide values
ANDAndorraAREUnited Arab EmiratesARGArgentinaARMArmeniaASMAmerican SamoaATFFrench Southern and Antarctic LandsATGAntigua and BarbudaAUSAustraliaAUTAustriaAZEAzerbaijanBDIBurundiBELBelgiumBENBeninBESCaribbean Netherlands (Bonaire, Sint Eustatius, and Saba)BFABurkina FasoBGDBangladeshBGRBulgariaBHRBahrainBHSBahamasBIHBosnia and HerzegovinaBLMSaint BarthélemyBLZBelizeBMUBermudaBOLBoliviaBRABrazilBRBBarbadosBRNBruneiBTNBhutanBVTBouvet IslandBWABotswanaCANCanadaCCKCocos IslandsCHESwitzerlandCHLChileCHNChinaCIVCôte d'Ivoire (Ivory Coast)CMRCameroonCOGRepublic of CongoCOKCook IslandsCOLColombiaCOMComorosCPVCape VerdeCRICosta RicaCUWCuraçaoCXRChristmas IslandCYMCayman IslandsCYPCyprusCZECzechia (Czech Republic)DEUGermanyDJIDjiboutiDMADominicaDNKDenmarkDOMDominican RepublicDZAAlgeriaECUEcuadorEGYEgyptERIEritreaESHWestern SaharaESPSpainESTEstoniaETHEthiopiaFINFinlandFJIFijiFLKFalkland IslandsFRAFranceFROFaroe IslandsFSMMicronesiaGABGabonGBRUnited KingdomGEOGeorgiaGGYGuernseyGHAGhanaGIBGibraltarGINGuineaGLPGuadeloupeGMBGambiaGNBGuinea-BissauGNQEquatorial GuineaGRCGreeceGRDGrenadaGRLGreenlandGTMGuatemalaGUFFrench GuianaGUMGuamGUYGuyanaHKGHong KongHMDHeard Island and McDonald IslandsHNDHondurasHRVCroatiaHUNHungaryIDNIndonesiaIMNIsle of ManINDIndiaIOTBritish Indian Ocean TerritoryIRLIrelandIRQIraqISLIcelandISRIsraelITAItalyJAMJamaicaJEYJerseyJORJordanJPNJapanKAZKazakhstanKENKenyaKGZKyrgyzstanKHMCambodiaKIRKiribatiKNASaint Kitts and NevisKORSouth KoreaKWTKuwaitLAOLao People's Democratic Republic (Laos)LBNLebanonLBRLiberiaLCASaint LuciaLIELiechtensteinLKASri LankaLSOLesothoLTULithuaniaLUXLuxembourgLVALatviaMACMacaoMAFSaint MartinMARMoroccoMCOMonacoMDAMoldovaMDGMadagascarMDVMaldivesMEXMexicoMHLMarshall IslandsMKDMacedoniaMLTMaltaMNEMontenegroMNGMongoliaMNPNorthern Mariana IslandsMOZMozambiqueMRTMauritaniaMSRMontserratMTQMartiniqueMUSMauritiusMWIMalawiMYSMalaysiaMYTMayotteNAMNamibiaNCLNew CaledoniaNERNigerNFKNorfolk IslandNGANigeriaNIUNiueNLDNetherlandsNORNorwayNPLNepalNRUNauruNZLNew ZealandOMNOmanPAKPakistanPANPanamaPCNPitcairnPERPeruPHLPhilippinesPLWPalauPNGPapua New GuineaPOLPolandPRIPuerto RicoPRTPortugalPRYParaguayPSEPalestinian territoriesPYFFrench PolynesiaQATQatarREUReunionROMRomaniaRWARwandaSAUSaudi ArabiaSENSenegalSGPSingaporeSGSSouth Georgia and the South Sandwich IslandsSHNSaint HelenaSJMSvalbard and Jan MayenSLBSolomon IslandsSLESierra LeoneSLVEl SalvadorSMRSan MarinoSPMSaint Pierre and MiquelonSRBRepublic of SerbiaSTPSão Tomé and PrÃncipeSURSurinameSVKSlovakiaSVNSloveniaSWESwedenSWZSwazilandSXMSint MaartenSYCSeychellesTCATurks and Caicos IslandsTCDChadTGOTogoTHAThailandTJKTajikistanTKLTokelauTKMTurkmenistanTLSTimor-LesteTONTongaTTOTrinidad and TobagoTUNTunisiaTURTurkeyTUVTuvaluTWNTaiwanTZATanzaniaUGAUgandaUKRUkraineUMIUnited States Minor Outlying IslandsURYUruguayUSAUnited StatesUZBUzbekistanVATHoly See (Vatican City)VCTSaint Vincent and the GrenadinesVGBBritish Virgin IslandsVIRU.S. Virgin IslandsVNMVietnamVUTVanuatuWLFWallis and FutunaWSMSamoaXXKKosovoZAFSouth AfricaZMBZambia
Country code (3-letter ISO, unsupported)
Three-letter code for a country that Paddle doesn't support sales to. Typically an ISO 3166-1 alpha-3 code, though Paddle uses a small number of codes that ISO doesn't currently assign.
Values
AFGAfghanistanANTNetherlands Antilles. Withdrawn ISO 3166-1 code, succeeded by BQ, CW and SX.ATAAntarcticaBLRBelarusCAFCentral African Republic
+ Show all values− Hide values
CODDemocratic Republic of CongoCUBCubaHTIHaitiIRNIranLBYLibyaMLIMaliMMRMyanmar (Burma)NICNicaraguaPRKNorth KoreaRUSRussiaSCGSerbia and Montenegro. Withdrawn ISO 3166-1 code, succeeded by RS and ME.SDNSudanSOMSomaliaSSDSouth SudanSYRSyriaVENVenezuelaYEMYemenZWEZimbabwe
namestringrequired
Formal English name of the country, in uppercase ASCII characters only. Typically the ISO 3166-1 name. Use
printable_name for display.printable_namestringrequired
Common English name of the country, formatted for display.
uses_postal_codebooleanrequired
Whether Paddle requires a postal code as part of addresses in this country.
transaction_currencystringrequired
Currency used for automatic price conversion when the customer is in this country.
Values
USDUnited States DollarEUREuroGBPPound SterlingJPYJapanese YenAUDAustralian Dollar
+ Show all values− Hide values
CADCanadian DollarCHFSwiss FrancHKDHong Kong DollarSGDSingapore DollarSEKSwedish KronaARSArgentine PesoBRLBrazilian RealCLPChilean PesoCNYChinese YuanCOPColombian PesoCZKCzech KorunaDKKDanish KroneHUFHungarian ForintILSIsraeli ShekelINRIndian RupeeKRWSouth Korean WonMXNMexican PesoNOKNorwegian KroneNZDNew Zealand DollarPENPeruvian SolPLNPolish ZlotyRUBRussian RubleTHBThai BahtTRYTurkish LiraTWDNew Taiwan DollarUAHUkrainian HryvniaVNDVietnamese DongZARSouth African Rand
payout_currencystringrequired
Default payout currency for this country. You can set your payout currency in the dashboard, so it may differ from this default.
Values
AUDAustralian DollarCADCanadian DollarCHFSwiss FrancCNYChinese YuanCZKCzech Koruna
+ Show all values− Hide values
DKKDanish KroneEUREuroGBPPound SterlingHUFHungarian ForintPLNPolish ZlotySEKSwedish KronaUSDUnited States DollarZARSouth African Rand
allow_salesbooleanrequired
Whether Paddle supports sales to customers in this country.
false means sales aren't permitted. This typically means a country is restricted by sanctions or policy, uses a withdrawn ISO 3166-1 code, or has no commercial applicability. Other risk and compliance checks may still prevent an individual sale.has_regionsbooleanrequired
Whether Paddle holds region data for this country. Regions are only defined where sales are restricted below country level.
tax_modestringrequired
How tax is presented for prices to customers in this country by default.
Values
internalPrices are inclusive of tax.externalPrices are exclusive of tax.
metaobjectrequired
Information about this response.
request_idstringrequired
Example:
b15ec92e-8688-40d4-a04d-f44cbec93355Unique ID for the request relating to this response. Provide this when contacting Paddle support about a specific request.
{ "data": [ { "iso": "US", "iso3": "USA", "name": "UNITED STATES", "printable_name": "United States", "uses_postal_code": true, "transaction_currency": "USD", "payout_currency": "USD", "allow_sales": true, "has_regions": false, "tax_mode": "external" }, { "iso": "GB", "iso3": "GBR", "name": "UNITED KINGDOM", "printable_name": "United Kingdom", "uses_postal_code": true, "transaction_currency": "GBP", "payout_currency": "GBP", "allow_sales": true, "has_regions": false, "tax_mode": "internal" }, { "iso": "DE", "iso3": "DEU", "name": "GERMANY", "printable_name": "Germany", "uses_postal_code": true, "transaction_currency": "EUR", "payout_currency": "EUR", "allow_sales": true, "has_regions": false, "tax_mode": "internal" }, { "iso": "UA", "iso3": "UKR", "name": "UKRAINE", "printable_name": "Ukraine", "uses_postal_code": false, "transaction_currency": "UAH", "payout_currency": "USD", "allow_sales": true, "has_regions": true, "tax_mode": "internal" }, { "iso": "JP", "iso3": "JPN", "name": "JAPAN", "printable_name": "Japan", "uses_postal_code": false, "transaction_currency": "JPY", "payout_currency": "USD", "allow_sales": true, "has_regions": false, "tax_mode": "internal" } ], "meta": { "request_id": "d2f61b0a-8c47-4f9e-b0a3-3f5c1e9a7b42" }}