Sample - Stripe API
GET/v1/country_specs/{country}

Get a country specification

Retrieves the country specification for a specified country code. Use expand to request additional response fields when needed, and ensure country identifies the country specification you want to retrieve.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

2 parameters
countrystringrequired
The country code identifying the country specification to retrieve.
expandarray<string>optional
Fields to expand in the response; each value must be no more than 5000 characters.

2 status codes
200Returns a country specification containing the default currency, supported payment and bank account currencies, supported payment methods and transfer countries, and verification fields.
default_currencystringrequired
The default currency for this country. This applies to both payment methods and bank accounts.
idstringrequired
Unique identifier for the object. Represented as the ISO country code for this country.
objectstringrequired
String representing the object's type. Objects of the same type share the same value.
Allowed:country_spec
supported_bank_account_currenciesobjectrequired
Currencies that can be accepted in the specific country (for transfers).
supported_payment_currenciesarray<string>required
Currencies that can be accepted in the specified country (for payments).
supported_payment_methodsarray<string>required
Payment methods available in the specified country. You may need to enable some payment methods (e.g., [ACH](https://stripe.com/docs/ach)) on your account before they appear in this list. The `stripe` payment method refers to [charging through your platform](https://stripe.com/docs/connect/destination-charges).
supported_transfer_countriesarray<string>required
Countries that can accept transfers from the specified country.
verification_fieldsobjectrequired
defaultReturned when the API reports an error and includes an `error` object describing the failure.
errorobjectrequired

Error handling

country must be a string of no more than 5000 characters and identify a country specification. Each value in expand must be a string of no more than 5000 characters.