---
title: "Rerank documents (Cohere format)"
method: POST
path: "/cohere/v2/rerank"
tags: ["Cohere Integration"]
---

# Rerank documents (Cohere format)

`POST /cohere/v2/rerank`

Reranks a list of documents against a query using Cohere's v2 Rerank
API. The request body matches Cohere's native format.

## Request body

- object
  - `model` string, required — Cohere rerank model identifier (e.g. `rerank-english-v3.0`).
  - `query` string, required — Query string to rank documents against.
  - `documents` union[], required — Documents to rerank. Strings or objects with a `text` field.
    - union
      - string
      - object
        - `text` string, required
  - `top_n` integer — Return only the top N reranked results.
  - `return_documents` boolean — Include the original document text in the response.
  - `max_tokens_per_doc` integer — Truncate each document to this token limit before ranking.

## Response `200`

Successful response

- object
  - `id` string
  - `results` object[]
    - `index` integer
    - `relevance_score` number
    - `document` object
  - `meta` object

## Other responses

- `400` — Bad request
- `500` — Internal server error

---

[API](https://skmtc.net/getbifrost/apis/bifrost-api.md) · [All operations](https://skmtc.net/getbifrost/apis/bifrost-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getbifrost/bifrost-api/versions/f8cab88f64ea/schema)