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

# Introduction

> The Magna Admin API is a private, server-to-server API for managing allocations, funding and claims, transactions, and token data from your own backend.

The **Admin API** (also called the Magna External API) lets you integrate Magna
features outside of the Magna platform. With it you can retrieve allocation
lists for a project, fund those allocations, trigger claims and withdrawals,
index transactions, and read token supply data — all from your own backend.

It is a **private** API: every request is authenticated with a project API key
that you generate in the Magna admin dashboard. It is intended for
server-to-server automation and back-office workflows, not high-frequency public
traffic. For the public, browser-facing API behind claim portals, see the
[Portal API](/apis/portal/overview).

Magna issues two kinds of key — a **Full Access API Token** for everything and a
read-only **Statistics API Key** for the supply endpoints. See
[Authentication → API key types](/apis/admin/authentication#api-key-types).

## Base URL

```
https://app.magna.so/api/external/v1
```

## Response envelope

Successful responses return the requested resource as JSON. Errors return a
consistent envelope:

```json theme={null}
{
  "isProcessed": false,
  "error": {
    "type": "ForbiddenError",
    "message": "Invalid API key for project"
  }
}
```

<Note>
  Every request must include your API key in the `x-magna-api-token` header. See
  [Authentication](/apis/admin/authentication) to generate a key and learn about
  scopes.
</Note>

## What you can do

<CardGroup cols={2}>
  <Card title="Allocations" icon="coins" href="/apis/admin/allocations">
    List, create, modify, claim, and release allocations.
  </Card>

  <Card title="Transactions" icon="arrow-right-arrow-left" href="/apis/admin/transactions">
    Build signing parameters and index transactions.
  </Card>

  <Card title="Tokens" icon="circle-dollar-to-slot" href="/apis/admin/tokens">
    Read token summaries and supply figures.
  </Card>

  <Card title="Statistics" icon="chart-simple" href="/apis/admin/statistics/total-supply">
    Read total, unlocked, and locked token supply.
  </Card>
</CardGroup>