> ## Documentation Index
> Fetch the complete documentation index at: https://docs.donate.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# Move to api.donate.gg

> www.donate.gg/api stops working on 20 November 2026. Change your base URL to api.donate.gg.

The donate.gg API moved to its own host, `api.donate.gg`. The old address, `www.donate.gg/api` (and `donate.gg/api`), **stops working on 20 November 2026 at 00:00 UTC**. From then on, every request to it returns `410 Gone`.

## What to change

Change the host in your base URL. Nothing else changes.

| Before | After |
| - | - |
| `https://www.donate.gg/api/v1` | `https://api.donate.gg/api/v1` |
| `https://donate.gg/api/v1` | `https://api.donate.gg/api/v1` |

```diff theme={null}
- const BASE_URL = 'https://www.donate.gg/api/v1';
+ const BASE_URL = 'https://api.donate.gg/api/v1';
```

On `api.donate.gg`, these stay the same:

* **Paths and methods.** `/api/v1/charities` on the old host is `/api/v1/charities` on the new one.
* **API keys.** Send the same `donate-api-key` header. You don't need a new key.
* **Requests and responses.** Bodies, query parameters, status codes and error codes are the same.
* **Rate limits.** Keyed calls share your organization's limit, and anonymous reads are limited per IP, as before. See [Rate Limits](https://docs.donate.gg/developer/rate-limits.md).
* **OpenAPI and Postman.** Download them from [`api.donate.gg/api/openapi`](https://api.donate.gg/api/openapi) and [`api.donate.gg/api/postman`](https://api.donate.gg/api/postman).

## Check that you've moved

Search your code and configuration for `donate.gg/api` and replace each match that isn't already `api.donate.gg`. Look in environment variables, reverse-proxy rules and any copy of the OpenAPI document or Postman collection you saved.

Until 20 November 2026, every response from the old host carries these headers, so you can spot calls that still use it:

| Header | Value |
| - | - |
| `Deprecation` | `@1792627200` (deprecated since 22 October 2026) |
| `Sunset` | `Fri, 20 Nov 2026 00:00:00 GMT` |
| `Link` | The same request on `api.donate.gg`, with `rel="successor-version"` |

## After 20 November 2026

The old host answers every request with `410 Gone` and this body:

```json theme={null}
{
  "error": "This API address was retired on 20 November 2026. Use https://api.donate.gg/api instead.",
  "code": "GONE",
  "successor": "https://api.donate.gg/api/v1/charities",
  "docs": "https://docs.donate.gg/developer/api-host-migration"
}
```

`successor` is the same request on `api.donate.gg`. The old host doesn't redirect, so a client that ignores the status code won't be moved silently.

Questions? Email [support@donate.gg](mailto:support@donate.gg).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.