# Dofus — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/dofus/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/dofus/get-all-classes \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/dofus/get-almanax \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/dofus/get-class-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/dofus/get-player-by-name \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/dofus/get-rankings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/dofus/list-bugs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"status":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.