# Pokedex



The pokedex itself — look up any Pokemon by name or number, or page through all of them.



## Pokemon

The pokedex entry — types, abilities, stats, and artwork, by dex number or name.

- Method: `GET`
- Path: `/v1/entertainment/pokemon`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `id` | string | required | Dex number or name. |

**Example request**

```bash
curl https://api.diraz.ae/v1/entertainment/pokemon \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "id": 25,
    "name": "pikachu",
    "types": ["electric"],
    "heightDm": 4,
    "weightHg": 60,
    "abilities": ["static", "lightning-rod"],
    "stats": [
      { "name": "hp", "value": 35 },
      { "name": "attack", "value": 55 },
      { "name": "speed", "value": 90 }
    ],
    "artworkUrl": "https://raw.githubusercontent.com/PokeAPI/sprites/master/sprites/pokemon/other/official-artwork/25.png"
  },
  "meta": { "request_id": "req_7Q2fK4mZ" }
}
```

## Pokedex List

The pokedex listing — page through every Pokemon that exists.

- Method: `GET`
- Path: `/v1/entertainment/pokedex`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `limit` | integer | optional | 1 to 100 per page. |
| `offset` | integer | optional | 0 to 1300. |
| `max_age` | integer (seconds) | optional | Ask for data no older than this. Clamped to the product's own floor, so it can narrow the window but never force a refresh on every call. |

**Example request**

```bash
curl https://api.diraz.ae/v1/entertainment/pokedex \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "total": 1302,
    "results": [
      { "id": 1, "name": "bulbasaur" },
      { "id": 2, "name": "ivysaur" },
      { "id": 3, "name": "venusaur" }
    ]
  },
  "meta": { "request_id": "req_7Q2fK4mZ", "as_of": "2026-08-22T04:05:00.000Z", "age_seconds": 42, "next_update_at": "2026-08-23T04:05:00.000Z" }
}
```