# Digimon API
> The Digimon universe as an API — every Digital Monster with its evolution stage (Baby through Mega/Ultimate), types, attributes (Vaccine, Virus, Data, Free), fields, signature skills, release date and full prior/next evolution lines. Look up a Digimon by name or id (e.g. Agumon → Child stage, Reptile type, with its 88 possible evolutions and 18 skills), search the database and filter by attribute, level, type or field (e.g. all Vaccine Adults), and browse the reference taxonomies. Each entry carries artwork and an English description. Backed by the open digi-api.com dataset. Ideal for fan sites, evolution and team-building tools, trivia and quiz games, Discord bots and any Digimon app.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/digimon-api/..."
```

## Pricing
- **Free** (Free) — 10,100 calls/Mo, 2 req/s
- **Starter** ($3/Mo) — 146,000 calls/Mo, 8 req/s
- **Pro** ($10/Mo) — 675,000 calls/Mo, 20 req/s
- **Mega** ($32/Mo) — 2,810,000 calls/Mo, 50 req/s

## Endpoints

### Digimon

#### `GET /v1/digimon` — A Digimon by id or exact name

**Parameters:**
- `name` (query, optional, string) — Digimon name, e.g. agumon Example: `agumon`
- `id` (query, optional, string) — Digimon id

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/digimon-api/v1/digimon?name=agumon"
```

**Response:**
```json
{
    "data": {
        "digimon": {
            "id": 1,
            "name": "Agumon",
            "image": "https://digi-api.com/images/digimon/w/Agumon.png",
            "types": [
                "Reptile"
            ],
            "fields": [
                "Deep Savers",
                "Dragon's Roar",
                "Metal Empire",
                "Nature Spirits",
                "Nightmare Soldiers",
                "Virus Busters"
            ],
            "levels": [
                "Child"
            ],
            "skills": [
                "Baby Flame",
                "Spitfire",
                "Cross Fight",
                "Surudoi Tsume",
                "Sharp Nail",
                "Baby Burner",
                "Triple Baby Flame",
                "Battle Hawk",
                "Kūchū Baby Flame",
                "Mach Jab",
                "Mach Jab Combo",
                "Dynamite Kick",
                "Uppercut",
                "Agumon Dive",
                "Wild Whip",
                "Final Claw",
                "Splash Kick",
                "Aerial Mach Jab"
            ],
            "attributes": [
                "Vaccine"
            ],
            "x_antibody": false,
            "description": "A Reptile Digimon with an appearance resembling a small dinosaur, it has grown and become able to walk on two legs. Its strength is weak as it is still in the process of growing, but it has a fearless and rather ferocious personality. Ha
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/search` — Search & filter Digimon

**Parameters:**
- `name` (query, optional, string) — Name search, e.g. greymon Example: `greymon`
- `attribute` (query, optional, string) — Attribute filter: Vaccine | Virus | Data | Free
- `level` (query, optional, string) — Level filter, e.g. Adult
- `type` (query, optional, string) — Type filter, e.g. Dragon
- `page` (query, optional, string) — Page number (starts at 0) Example: `0`
- `pageSize` (query, optional, string) — Page size (1-100, default 20) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/digimon-api/v1/search?name=greymon&page=0&pageSize=20"
```

**Response:**
```json
{
    "data": {
        "page": 0,
        "count": 8,
        "total": 8,
        "results": [
            {
                "id": 34,
                "name": "Greymon",
                "image": "https://digi-api.com/images/digimon/w/Greymon.png"
            },
            {
                "id": 396,
                "name": "Greymon (Blue)",
                "image": "https://digi-api.com/images/digimon/w/Greymon_(Blue).png"
            },
            {
                "id": 730,
                "name": "Greymon (X-Antibody)",
                "image": "https://digi-api.com/images/digimon/w/Greymon_(X-Antibody).png"
            },
            {
                "id": 1006,
                "name": "Greymon (2010 Anime Version)",
                "image": "https://digi-api.com/images/digimon/w/Greymon_(2010_Anime_Version).png"
            },
            {
                "id": 1007,
                "name": "Greymon (Ash)",
                "image": "https://digi-api.com/images/digimon/w/Greymon_(Ash).png"
            },
            {
                "id": 1008,
                "name": "Greymon O",
                "image": "https://digi-api.com/images/digimon/w/Greymon_O.png"
            },
            {
                "id": 1009,
                "name": "Greymon (Skull Knightmon)",
                "image": "https://digi-api.com/images/digimon/w/Greymon_(Skull_Knightmon).png"
            },
            {
                "id": 1425,
                "name": "Greymon (Blue) (X-Antibo
…(truncated, see openapi.json for full schema)
```

### Reference

#### `GET /v1/reference` — Browse a taxonomy

**Parameters:**
- `type` (query, required, string) — levels | types | attributes | fields | skills Example: `levels`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/digimon-api/v1/reference?type=levels"
```

**Response:**
```json
{
    "data": {
        "type": "levels",
        "count": 5,
        "results": [
            {
                "id": 1,
                "name": "Baby II"
            },
            {
                "id": 2,
                "name": "Adult"
            },
            {
                "id": 3,
                "name": "Perfect"
            },
            {
                "id": 4,
                "name": "Child"
            },
            {
                "id": 5,
                "name": "Baby I"
            }
        ],
        "description": "An Evolution Stage, also referred to as Level and Generation, is the level of development a Digimon is at."
    },
    "meta": {
        "timestamp": "2026-06-01T00:04:26.035Z",
        "request_id": "6f8a0130-e79d-47aa-9f72-ef3e5c0d1965"
    },
    "status": "ok",
    "message": "Reference retrieved",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Reference types & usage notes

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/digimon-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "The Digimon universe. /v1/digimon = a Digimon by id or exact name (e.g. name=agumon) with its level, types, attributes, fields, skills, descriptions and prior/next evolutions; /v1/search = search by name and filter by attribute, level, type or field (paged from page 0); /v1/reference = browse a taxonomy (type=levels|types|attributes|fields|skills).",
        "source": "digi-api.com",
        "endpoints": [
            "/v1/digimon",
            "/v1/search",
            "/v1/reference",
            "/v1/meta"
        ],
        "reference_types": [
            "levels",
            "types",
            "attributes",
            "fields",
            "skills"
        ]
    },
    "meta": {
        "timestamp": "2026-06-01T00:04:26.103Z",
        "request_id": "cd988516-8ee5-4621-9283-91d78338ba66"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/digimon-api
OpenAPI spec: https://www.oanor.com/api/digimon-api/openapi.json
