Skip to main content

Get country availability

GET /v1/available-countries

List of countries where crypto purchases are supported.

HTTP request

https://fiat-api.changelly.com/v1/available-countries

Request

Header parameters

NameTypeRequiredDescription
X-Api-KeystringtrueYour public API key.
X-Api-SignaturestringtrueThe query's serialized body signed by your private key according to the RSA-SHA256 method.

Query parameters

NameTypeRequiredDescription
providerCodestringfalseThe provider code. Possible values.
If the provider code is not specified, the endpoint will return the supported currencies for all providers.
supportedFlowstringfalseEnum: buy/sell.
If the flow is not specified, the endpoint will return result for both cases (On-Ramp buy and Off-Ramp sell).

Response

Sample response

application/json
[
{
"code": "FR",
"name": "France"
},
{
"code": "EE",
"name": "Estonia"
}
]

Response params

NameTypeRequiredDescription
codestringtrueCountry ISO 3166-1 code (Alpha-2).
namestringtrueCountry name.
statesarray of objectsfalseIs returned if the code of the country is US.

states object:

NameTypeDescription
codestringState ISO 3166-2 code.
namestringState name.

Error schema

NameTypeRequiredDescription
errorTypestringtrueError type.
errorMessagestringtrueError message.
errorDetailsarray of objectstrueIf the error contains no details, errorDetails equals null.

Possible error types:

TypeDescription
validationValidation error.

errorDetails item schema

NameTypeRequiredDescription
causestringtrueError cause. For example, it can equal the missing request parameter for the validation error type.
valuestringtrueError value.

Error codes

CodeMessage
400BadRequest
401Unauthorized
429TooManyRequests
500InternalServerError
BadRequest
{
"errorType": "validation",
"errorMessage": "Validation error",
"errorDetails": [
{
"cause": "providerCode",
"value": "Incorrect provider code"
}
]
}