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

# Overview

> Integrate donate.gg into your product with the Developer API

The donate.gg Developer API lets you embed verified charitable giving directly into your product. Browse our verified charity network, customize donation routes, and deliver on-chain donations.

## What you can build

* **Donation widgets**: embed a charity selector in your app backed by real verified charities
* **Programmatic giving**: customize donation delivery on behalf of your users
* **On-chain integration**: call our contracts directly in your blockchain layer
* **Source leaderboards**: track donation activity per token for donation sources owned by your project
* **Charity token stats**: fetch public token routes and leaderboard data with your API key

<Card title="Use Case" icon="book" href="/developer/use-case">
  A scenario-based Donate.gg API integration walkthrough
</Card>

## Core concepts

<CardGroup cols={2}>
  <Card title="Charities" icon="building-columns">
    Browse and search the full list of verified non-profits on donate.gg, including metadata and
    social links.
  </Card>

  <Card title="Configs" icon="sliders">
    A config defines how donations are routed, who the beneficiaries are and their distribution
    weight. Includes aggregate donation stats per config.
  </Card>

  <Card title="Chains" icon="link">
    Query which EVM and Solana chains are currently supported for donations.
  </Card>

  <Card title="Source Leaderboard" icon="trophy" href="/developer/source-leaderboard">
    View token-level donation stats for donation sources owned by your developer project.
  </Card>
</CardGroup>

## API Reference

<Card title="API Reference" icon="code" href="/api-reference">
  Full endpoint documentation with an interactive playground
</Card>

## Base URL

All API requests are made to:

```
https://www.donate.gg/api/v1
```

Machine-readable specs are available at [`/api/v1/openapi`](https://www.donate.gg/api/v1/openapi) (OpenAPI 3.0.0 JSON) and [`/api/v1/postman`](https://www.donate.gg/api/v1/postman) (Postman collection). Both are public and do not require authentication.

## Next steps

<CardGroup cols={2}>
  <Card title="Getting Access" icon="key" href="/developer/getting-access">
    Request an API key to get started
  </Card>

  <Card title="Authentication" icon="lock" href="/developer/authentication">
    Learn how to authenticate your requests
  </Card>
</CardGroup>