• Register

Country code lookup

Virgin Money Giving has closed

Page and account creation APIs are now unavailable so please consider your use of our APIs and how this affects you. All other APIs will be available until 18 February. If you have any questions please take a look at our Q&A.

Read our Q&A

Country code lookup

This API returns a list of country descriptions and their code. When entering an address for a new fundraising account, the country code is a required entry.

As this data rarely changes you may wish to retrieve the list from the IO Docs.


Operation type: GET

Parameter Required Data type Description
api_key True Varchar (24) This is your key that allows you access to the VMG APIs.


OutcomeFurther information

This API will return the following fields:

  • Status 200: OK

Country details in the following format:

  • Country code
  • Country name

Sample error:

If no country codes can be found the following is returned:

  • Error Code: 001.02.005
  • Error message: Could not retrieve country code details.

Click here for a full list of API error codes.

Response description

ParamterData typeDescription
countryCode Varchar10) This is the country code which needs to be provided by the fundraiser account creation API.
countryName Varchar(50) This is the name of the country associated with the country code.

XML response example

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

JSON response example

    "countries": [{
        "countryCode": "AF",
        "countryName": "Afghanistan"
    }, {
        "countryCode": "AL",
        "countryName": "Albania"