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
- Request
- cURL
Header parameters
Name | Type | Required | Description |
---|---|---|---|
X-Api-Key | string | true | Your public API key. |
X-Api-Signature | string | true | The query's serialized body signed by your private key according to the RSA-SHA256 method. |
Query parameters
Name | Type | Required | Description |
---|---|---|---|
providerCode | string | false | The provider code. Possible values. If the provider code is not specified, the endpoint will return the supported currencies for all providers. |
supportedFlow | string | false | Enum: buy /sell .If the flow is not specified, the endpoint will return result for both cases (On-Ramp buy and Off-Ramp sell ). |
curl --location --request GET
'https://fiat-api.changelly.com/v1/available-countries?providerCode=moonpay&supportedFlow=sell'
--header 'X-Api-Key: {{apiKey}}'
--header 'X-Api-Signature: {{signature}}'
Response
Sample response
application/json
[
{
"code": "FR",
"name": "France"
},
{
"code": "EE",
"name": "Estonia"
}
]
Response params
Name | Type | Required | Description |
---|---|---|---|
code | string | true | Country ISO 3166-1 code (Alpha-2). |
name | string | true | Country name. |
states | array of objects | false | Is returned if the code of the country is US . |
states
object:
Name | Type | Description |
---|---|---|
code | string | State ISO 3166-2 code. |
name | string | State name. |
Error schema
Name | Type | Required | Description |
---|---|---|---|
errorType | string | true | Error type. |
errorMessage | string | true | Error message. |
errorDetails | array of objects | true | If the error contains no details, errorDetails equals null. |
Possible error types:
Type | Description |
---|---|
validation | Validation error. |
errorDetails
item schema
Name | Type | Required | Description |
---|---|---|---|
cause | string | true | Error cause. For example, it can equal the missing request parameter for the validation error type. |
value | string | true | Error value. |
Error codes
Code | Message |
---|---|
400 | BadRequest |
401 | Unauthorized |
429 | TooManyRequests |
500 | InternalServerError |
- 400
- 401
- 429
- 500
BadRequest
{
"errorType": "validation",
"errorMessage": "Validation error",
"errorDetails": [
{
"cause": "providerCode",
"value": "Incorrect provider code"
}
]
}
Unauthorized
{
"errorType": "unauthorized",
"errorMessage": "Unauthorized",
"errorDetails": null
}
TooManyRequests
{
"errorType": "tooManyRequests",
"errorMessage": "Too many requests",
"errorDetails": null
}
InternalServerError
{
"errorType": "internalServerError",
"errorMessage": "Internal Server Error",
"errorDetails": null
}