---
title: "GET /characters"
method: GET
path: "/characters"
tags: ["characters"]
---

# GET /characters

`GET /characters`

## Request

- Base URL: `https://api.jikan.moe/v4`
- URL: `https://api.jikan.moe/v4/characters`
- Auth: none declared

## Query parameters

- `page` integer
- `limit` integer
- `q` string
- `order_by` 'mal_id' | 'name' | 'favorites': Available Character order_by properties
- `sort` 'desc' | 'asc': Search query sort direction
- `letter` string

## Response `200`

Returns search results for characters

- CharactersSearch: Characters Search Resource
  - `data` Character[]
    - `mal_id` integer: MyAnimeList ID
    - `url` string: MyAnimeList URL
    - `images` CharacterImages
      - `jpg` object: Available images in JPG
        - `image_url` string, nullable: Image URL JPG
        - `small_image_url` string, nullable: Small Image URL JPG
      - `webp` object: Available images in WEBP
        - `image_url` string, nullable: Image URL WEBP
        - `small_image_url` string, nullable: Small Image URL WEBP
    - `name` string: Name
    - `name_kanji` string, nullable: Name
    - `nicknames` string[]: Other Names
    - `favorites` integer: Number of users who have favorited this entry
    - `about` string, nullable: Biography
  - `pagination` object
    - `last_visible_page` integer
    - `has_next_page` boolean
    - `current_page` integer
    - `items` object
      - `count` integer
      - `total` integer
      - `per_page` integer

## Other responses

- `400`: Error: Bad request. When required parameters were not supplied.

## Changes

- **2025-04-17** `b0fa1e34a3f0`: 1 info
  - added the optional property `allOf[#/components/schemas/pagination_plus]/pagination/current_page` to the response with the `200` status

[Operation history](https://skmtc.dev/jikan/apis/jikan-api/changes/characters/get.md)

---

[API](https://skmtc.dev/jikan/apis/jikan-api.md) - [All operations](https://skmtc.dev/jikan/apis/jikan-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jikan/apis/jikan-api/revisions/ae6dd9d554d6?raw)