# Dofus — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access comprehensive Dofus 3.0 game data including detailed class information, current bug reports, daily Almanax rewards, and player rankings. Explore the full encyclopedia and community statistics to optimize your gameplay and stay updated on game status.

**Category:** Entertainment | **Website:** [dofus.com/](https://dofus.com/) | **Docs:** [parse.bot/marketplace/3164af25-293c-4cc8-92b3-5f9032393a11/dofus-com-api](https://parse.bot/marketplace/3164af25-293c-4cc8-92b3-5f9032393a11/dofus-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-dofus-com-api-3164af25/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_all_classes

Get all playable character classes from the Dofus encyclopedia. Returns 19 classes with their IDs, slugs, display names, page URLs, and avatar image URLs. Each class entry provides the id and slug needed for get_class_detail.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dofus-com-api-3164af25/get_all_classes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_almanax

Get today's Almanax offering, bonus, quest, zodiac, and Meridia information from the Krosmoz calendar. Data refreshes daily. Returns a single day's almanax entry.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dofus-com-api-3164af25/get_almanax \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_class_detail

Get detailed information about a specific Dofus class including its display name, baseline role, all active roles, and lore description. Requires both the numeric id and slug (available from get_all_classes).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Numeric class ID from get_all_classes (e.g. '1' for Feca, '20' for Forgelance). |
| `slug` | string | Yes | Class slug from get_all_classes (e.g. 'feca', 'osamodas', 'forgelance'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dofus-com-api-3164af25/get_class_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id":"<string>","slug":"<string>"}'
```

### get_player_by_name

Look up a player by name on the Dofus leaderboards. Searches both the General (XP) and Achievement leaderboards to compile rank, class, server, level, total XP, and achievement points. Returns the first matching player or null if not found. Makes two requests (one to each leaderboard). The optional server parameter narrows results to a specific game server.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `name` | string | Yes | Player character name to search for (e.g. 'Hepaty'). |
| `server` | string | No | Server name to narrow the search (e.g. 'Shadow', 'Draconiros'). Case-insensitive. If omitted, searches across all servers. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dofus-com-api-3164af25/get_player_by_name \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"<string>","server":"<string>"}'
```

### get_rankings

Get the global achievement rankings (leaderboards) from the Dofus community page. Returns up to 100 players per page, ordered by achievement points descending. Paginated by page number.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination, 1-based. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dofus-com-api-3164af25/get_rankings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### list_bugs

Retrieve reported bugs from the Dofus bug tracker CSV. Returns up to 100 bugs per call. Optionally filter by status (case-insensitive match against the State column).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `status` | string | No | Filter by bug status. Case-insensitive match against the bug's State field. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dofus-com-api-3164af25/list_bugs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"<string>"}'
```