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

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

curl --location --request GET
'https://fiat-api.changelly.com/v1/available-countries'
--header 'X-Api-Key: {{apiKey}}'
--header 'X-Api-Signature: {{signature}}'

Response

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.
providers	array of objects	true	List of providers that support the country.

provider object schema:

Name	Type	Required	Description
providerCode	string	true	The On-Ramp or Off-Ramp provider code. Possible values. If the provider code is not specified, the endpoint will return the supported countries of all providers.
supportedFlow	array of strings	true	Enum: buy/sell. If the flow is not specified, the endpoint will return result for both cases (On-Ramp buy and Off-Ramp sell).

states object:

Name	Type	Description
code	string	State ISO 3166-2 code.
name	string	State name.

Sample response

application/json

{
  "code": "FR",
  "name": "France",
  "providers": [
    {
      "providerCode": "wert",
      "supportedFlows": [
        "buy"
      ]
    },
    {
      "providerCode": "moonpay",
      "supportedFlows": [
        "buy",
        "sell"
      ]
    },
    {
      "providerCode": "skrill_crypto",
      "supportedFlows": [
        "buy"
      ]
    },
    {
      "providerCode": "banxa",
      "supportedFlows": [
        "buy"
      ]
    },
    {
      "providerCode": "transak",
      "supportedFlows": [
        "buy"
      ]
    }
  ]
}

Error response

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

BadRequest

{
  "errorType": "validation",
  "errorMessage": "Validation error",
  "errorDetails": [
    {
      "cause": "providerCode",
      "value": "Incorrect provider code"
    }
  ]
}

401

Unauthorized

{
  "errorType": "unauthorized",
  "errorMessage": "Unauthorized",
  "errorDetails": null
}

429

TooManyRequests

{
  "errorType": "tooManyRequests",
  "errorMessage": "Too many requests",
  "errorDetails": null
}

500

InternalServerError

{
  "errorType": "internalServerError",
  "errorMessage": "Internal Server Error",
  "errorDetails": null
}