Get countries list

Get the list of countries that support crypto purchases.

HTTP request

get

/v1/available-countries

Request

Header parameters

Requires authentification.

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).

Sample 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.
providers	array of objects	true	List of providers that support the country.
states	array of objects	false	Is returned if the code of the country is US.

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).

state object schema

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

Sample response

application/json

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

Error response

Error response parameters

Check the error response schema.

Possible error types in the errorType item:

Type	Description
validation	Validation error.

The 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	Bad request
401	Unauthorized
404	Not found
429	Too many requests
500	Internal server error

400

Bad Request

{
  "errorType": "validation",
  "errorMessage": "Validation error",
  "errorDetails": [
    {
      "cause": "supportedFlow",
      "value": "each value in supportedFlow must be one of the following values: buy, sell"
    }
  ]
}

401

Unauthorized

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

404

Not Found

{
  "errorType": "notFound",
  "errorMessage": "Not found",
  "errorDetails": null
}

429

Too Many Requests

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

500

Internal Server Error

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