Endpoints and versioning

We maintain sandbox and production environments for testing and use, respectively, of the Account API. These environments are reachable based on the endpoint and credentials used to access them.

Sandbox environment endpoints start with the base URL:


Production environment endpoints are versioned, meaning that with each release of the Account API, a new set of endpoints for that version is generated. The current Account API version is v1, therefore the current base URL for production is:


For examples in this documentation, endpoints will be expressed as https://api.gravitypayments.com/{version}/*, where {version} is to be replaced by the version number you are accessing.

With each environment, you will use a different set of credentials. See Authenticating to the API for more details on your API credentials.

Using older versions

Older versions of the API will remain live and accessible whenever possible. Please note, however, that as the API and our industry evolves, there will inevitably be changes that deprecate old versions and require users to update to more recent versions. When this occurs, we will attempt to inform you by email, however we encourage you to keep your integration up to date whenever feasible.