---
title: "Get cloud evaluation of a position."
method: GET
path: "/api/cloud-eval"
tags: ["Analysis"]
---

# Get cloud evaluation of a position.

`GET /api/cloud-eval`

Get the cached evaluation of a position, if available.
Opening positions have more chances of being available. There are about 320 million positions in the database.
Up to 5 variations may be available. Variants are supported.
Use this endpoint to fetch a few positions here and there.
If you want to download a lot of positions, [get the full list](https://database.lichess.org/#evals) from our exported database.

## Query parameters

- `fen` string, required
- `multiPv` integer
- `variant` 'standard' | 'chess960' | 'crazyhouse' | 'antichess' | 'atomic' | 'horde' | 'kingOfTheHill' | 'racingKings' | 'threeCheck' | 'fromPosition'

## Response `200`

The evaluation of the position.

- CloudEval
  - `depth` integer, required
  - `fen` string, required
  - `knodes` integer, required
  - `pvs` union[], required
    - union
      - object
        - `cp` integer, required — Evaluation in centi-pawns, from White's point of view
        - `moves` string, required — Variation in UCI notation (King to rook for Chess960-compatible castling notation)
      - object
        - `mate` integer, required — Evaluation in moves to mate, from White's point of view
        - `moves` string, required — Variation in UCI notation (King to rook for Chess960-compatible castling notation)

## Other responses

- `404` — The position was not found in the cloud evaluation database.

---

[API](https://skmtc.net/lichess/apis/lichess-org-api-reference.md) · [All operations](https://skmtc.net/lichess/apis/lichess-org-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lichess/lichess-org-api-reference/versions/1425db81eb3b/schema)