Retrieve a Country Spec 

Returns a Country Spec for a given Country code.

Parameters

No parameters.

Returns

Returns a country_spec object if a valid country code is provided, and raises an error otherwise.

GET /v1/country_specs/:id
curl https://api.stripe.com/v1/country_specs/US \
-u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:"
Response
{
"id": "US",
"object": "country_spec",
"default_currency": "usd",
"supported_bank_account_currencies": {
"usd": [
"US"
]
},
"supported_payment_currencies": [
"usd",
"aed",
"afn",
"..."
],
"supported_payment_methods": [
"ach",
"card",
"stripe"
],
"supported_transfer_countries": [
"US",
"AE",
"AG",
"AL",
"AM",
"AR",
"AT",
"AU",
"BA",
"BE",
"BG",
"BH",
"BO",
"CA",
"CH",
"CI",
"CL",
"CO",
"CR",
"CY",
"CZ",
"DE",
"DK",
"DO",
"EC",
"EE",
"EG",
"ES",
"ET",
"FI",
"FR",
"GB",
"GH",
"GM",
"GR",
"GT",
"GY",
"HK",
"HR",
"HU",
"ID",
"IE",
"IL",
"IS",
"IT",
"JM",
"JO",
"JP",
"KE",
"KH",
"KR",
"KW",
"LC",
"LI",
"LK",
"LT",
"LU",
"LV",
"MA",
"MD",
"MG",
"MK",
"MN",
"MO",
"MT",
"MU",
"MX",
"MY",
"NA",
"NG",
"NL",
"NO",
"NZ",
"OM",
"PA",
"PE",
"PH",
"PL",
"PT",
"PY",
"QA",
"RO",
"RS",
"RW",
"SA",
"SE",
"SG",
"SI",
"SK",
"SN",
"SV",
"TH",
"TN",
"TR",
"TT",
"TZ",
"UY",
"UZ",
"VN",
"ZA",
"BD",
"BJ",
"MC",
"NE",
"SM",
"AZ",
"BN",
"BT",
"AO",
"DZ",
"TW",
"BS",
"BW",
"GA",
"LA",
"MZ",
"KZ",
"PK"
],
"verification_fields": {
"company": {
"additional": [],
"minimum": [
"business_profile.mcc",
"business_profile.url",
"business_type",
"company.address.city",
"company.address.line1",
"company.address.postal_code",
"company.address.state",
"company.name",
"company.owners_provided",
"company.phone",
"company.tax_id",
"external_account",
"owners.address.city",
"owners.address.line1",
"owners.address.postal_code",
"owners.address.state",
"owners.dob.day",
"owners.dob.month",
"owners.dob.year",
"owners.email",
"owners.first_name",
"owners.id_number",
"owners.last_name",
"owners.phone",
"owners.ssn_last_4",
"owners.verification.document",
"representative.address.city",
"representative.address.line1",
"representative.address.postal_code",
"representative.address.state",
"representative.dob.day",
"representative.dob.month",
"representative.dob.year",
"representative.email",
"representative.first_name",
"representative.id_number",
"representative.last_name",
"representative.phone",
"representative.relationship.executive",
"representative.relationship.title",
"representative.ssn_last_4",
"representative.verification.document",
"tos_acceptance.date",
"tos_acceptance.ip"
]
},
"individual": {
"additional": [],
"minimum": [
"business_profile.mcc",
"business_profile.url",
"business_type",
"external_account",
"individual.address.city",
"individual.address.line1",
"individual.address.postal_code",
"individual.address.state",
"individual.dob.day",
"individual.dob.month",
"individual.dob.year",
"individual.email",
"individual.first_name",
"individual.id_number",
"individual.last_name",
"individual.phone",
"individual.ssn_last_4",
"individual.verification.document",
"tos_acceptance.date",
"tos_acceptance.ip"
]
}
}
}

List Country Specs 

Lists all Country Spec objects available in the API.

Parameters

No parameters.

More parameters

  • ending_beforestring

  • limitinteger

  • starting_afterstring

Returns

Returns a list of country_spec objects.

GET /v1/country_specs
curl -G https://api.stripe.com/v1/country_specs \
-u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:" \
-d limit=3
Response
{
"object": "list",
"url": "/v1/country_specs",
"has_more": false,
"data": [
{
"id": "US",
"object": "country_spec",
"default_currency": "usd",
"supported_bank_account_currencies": {
"usd": [
"US"
]
},
"supported_payment_currencies": [
"usd",
"aed",
"afn",
"..."
],
"supported_payment_methods": [
"ach",
"card",
"stripe"
],
"supported_transfer_countries": [
"US",
"AE",
"AG",
"AL",
"AM",
"AR",
"AT",
"AU",
"BA",
"BE",
"BG",
"BH",
"BO",
"CA",
"CH",
"CI",
"CL",
"CO",
"CR",
"CY",
"CZ",
"DE",
"DK",
"DO",
"EC",
"EE",
"EG",
"ES",
"ET",
"FI",
"FR",
"GB",
"GH",
"GM",
"GR",
"GT",
"GY",
"HK",
"HR",
"HU",
"ID",
"IE",
"IL",
"IS",
"IT",
"JM",
"JO",
"JP",
"KE",
"KH",
"KR",
"KW",
"LC",
"LI",
"LK",
"LT",
"LU",
"LV",
"MA",
"MD",
"MG",
"MK",
"MN",
"MO",
"MT",
"MU",
"MX",
"MY",
"NA",
"NG",
"NL",
"NO",
"NZ",
"OM",
"PA",
"PE",
"PH",
"PL",
"PT",
"PY",
"QA",
"RO",
"RS",
"RW",
"SA",
"SE",
"SG",
"SI",
"SK",
"SN",
"SV",
"TH",
"TN",
"TR",
"TT",
"TZ",
"UY",
"UZ",
"VN",
"ZA",
"BD",
"BJ",
"MC",
"NE",
"SM",
"AZ",
"BN",
"BT",
"AO",
"DZ",
"TW",
"BS",
"BW",
"GA",
"LA",
"MZ",
"KZ",
"PK"
],
"verification_fields": {
"company": {
"additional": [],
"minimum": [
"business_profile.mcc",
"business_profile.url",
"business_type",
"company.address.city",
"company.address.line1",
"company.address.postal_code",
"company.address.state",
"company.name",
"company.owners_provided",
"company.phone",
"company.tax_id",
"external_account",
"owners.address.city",
"owners.address.line1",
"owners.address.postal_code",
"owners.address.state",
"owners.dob.day",
"owners.dob.month",
"owners.dob.year",
"owners.email",
"owners.first_name",
"owners.id_number",
"owners.last_name",
"owners.phone",
"owners.ssn_last_4",
"owners.verification.document",
"representative.address.city",
"representative.address.line1",
"representative.address.postal_code",
"representative.address.state",
"representative.dob.day",
"representative.dob.month",
"representative.dob.year",
"representative.email",
"representative.first_name",
"representative.id_number",
"representative.last_name",
"representative.phone",
"representative.relationship.executive",
"representative.relationship.title",
"representative.ssn_last_4",
"representative.verification.document",
"tos_acceptance.date",
"tos_acceptance.ip"
]
},
"individual": {
"additional": [],
"minimum": [
"business_profile.mcc",
"business_profile.url",
"business_type",
"external_account",
"individual.address.city",
"individual.address.line1",
"individual.address.postal_code",
"individual.address.state",
"individual.dob.day",
"individual.dob.month",
"individual.dob.year",
"individual.email",
"individual.first_name",
"individual.id_number",
"individual.last_name",
"individual.phone",
"individual.ssn_last_4",
"individual.verification.document",
"tos_acceptance.date",
"tos_acceptance.ip"
]
}
}
}
]
}

External Bank Accounts 

External bank accounts are financial accounts associated with a Stripe platform’s connected accounts for the purpose of transferring funds to or from the connected account’s Stripe balance.

External Account Cards 

External account cards are debit cards associated with a Stripe platform’s connected accounts for the purpose of transferring funds to or from the connected accounts Stripe balance.

This API is only available for users enrolled in the public preview for Accounts v2 on Stripe Connect. If you are not in this preview, please use the Accounts v1 API to manage your connected accounts’ external bank accounts instead.

Person 

This is an object representing a person associated with a Stripe account.

A platform can only access a subset of data in a person for an account where account.controller.requirement_collection is stripe, which includes Standard and Express accounts, after creating an Account Link or Account Session to start Connect onboarding.

See the Standard onboarding or Express onboarding documentation for information about prefilling information and account onboarding steps. Learn more about handling identity verification with the API.