---
title: "Rate an Anime."
method: POST
path: "/anime/{animeID}/rate"
tags: ["anime"]
---

# Rate an Anime.

`POST /anime/{animeID}/rate`

## Request

- Base URL: `https://api.kurozora.app/v1`
- URL: `https://api.kurozora.app/v1/anime/{animeID}/rate`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

This endpoint will allow user's to leave a rating for an Anime.

## Path parameters

- `animeID` string, required

## Request body `application/x-www-form-urlencoded`

- object
  - `rating` number, double, required: The rating to leave.
  - `description` string: The description accompanying the rating.

## Response `200`

Successful Kurozora JSON response

- object

## Other responses

- `400`: Error Kurozora JSON response
- `403`: Authentication error JSON response

## Changes

- **2025-03-16** `1308e95440e9`: 1 info
  - the endpoint scheme security `apiKey` was added to the API
- **2024-01-10** `a08d5d759c28`: 1 info
  - added the non-success response with the status `403`
- **2023-10-28** `c711bb3a57e3`: 1 info
  - for the `path` request parameter `animeID`, the type was generalized from `integer` to `string`
- **2021-12-17** `fd0b67484aeb`: 2 info
  - added the new optional request property `description`
  - the `rating` request property's min was decreased from `1.00` to `0.00`
- **2021-11-28** `32f393ace829`: 2 info
  - the endpoint scheme security `bearerAuth` was added to the API
  - the endpoint scheme security `kurozoraBearer` was removed from the API

[Operation history](https://skmtc.dev/kurozora/apis/kurozora-api/changes/anime/:animeID/rate/post.md)

---

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