Validate URL

When creating a new fundraising account, a unique URL is required. A team-based fundraising page also requires a unique URL.

This API checks a URL to see if it's available to be used.

A fundraising account is accessed by the following URL:

http://uk.virginmoneygiving.com/{url}

Most fundraisers use their own name as the {url}. Their account URL will be the same for any event they take part in 

A team fundraising page is accessed by the following URL:

http://uk.virginmoneygiving.com/team/{url}

Most teams choose their {url} based on their team name and perhaps the event e.g. SeabrookSealsChannelRelayTeam

If the URL is not unique, the API returns a list of alternatives in the message details.

URL

Operation type: GET

This validates a URL for a fundraising account:

https://api.virginmoneygiving.com/fundraisers/v1/urls/{url}.json?api_key={your API key}

This validates a URL for a team page:

https://api.virginmoneygiving.com/fundraisers/v1/urls/teams/{url}.json?api_key={your API key}

Parameters

Response

XML response examples

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<urlCheck>
  <requestedUrl>mytesturl</requestedUrl>
  <urlType>fundraiser</urlType>
  <available>true</available>
</urlCheck>

<connectErrors>
<error>
<errorCode>001.00.010</errorCode>
<errorMessage>This URL is unavailable. Please select an alternative URL.</errorMessage>
<messageDetails>mytesturl2</messageDetails>
<messageDetails>mytesturl3</messageDetails>
<messageDetails>mytesturl4</messageDetails>
<messageDetails>mytesturl5</messageDetails>
<messageDetails>mytesturl6</messageDetails>
</error>
</connectErrors>

JSON response examples

{
    "requestedUrl": "mytesturl",
    "urlType": "fundraiser",
    "available": true,
    "message": null,
    "alternateUrlList": []
}

{
    "errors":
    [
        {
            "responseCode": null,
            "errorCode": "001.00.010",
            "errorMessage": "This URL is unavailable. Please select an alternative URL.",
            "messageDetails":
            [
                "mytesturl2",
                "mytesturl3",
                "mytesturl4",
                "mytesturl5",
                "mytesturl6"
            ],
            "inputDetails": null
        }
    ]
}