Submit a rerank request | OpenRouter

Submits a rerank request to the rerank router

AuthorizationBearer

API key as bearer token in Authorization header

Rerank request input

documentslist of strings or objectsRequired

The list of documents to rerank. Documents may be plain strings, or structured objects with text and/or image for multimodal models.

modelstringRequired

The rerank model to use

querystringRequired

The search query to rerank documents against

providerobjectOptional

Provider routing preferences for the request.

top_nintegerOptional>=1

Number of most relevant documents to return

Rerank response

modelstring

The model used for reranking

resultslist of objects

List of rerank results sorted by relevance

idstring

Unique identifier for the rerank response (ORID format)

providerstring

The provider that served the rerank request

usageobject

Usage statistics

400

Bad Request Error

401

Unauthorized Error

402

Payment Required Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error

502

Bad Gateway Error

503

Service Unavailable Error

$	curl -X POST https://openrouter.ai/api/v1/rerank \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"documents": [
>	"Paris is the capital of France.",
>	"Berlin is the capital of Germany."
>	],
>	"model": "cohere/rerank-v3.5",
>	"query": "What is the capital of France?",
>	"top_n": 3
>	}'

1	{
2	"model": "cohere/rerank-v3.5",
3	"results": [
4	{
5	"document": {
6	"text": "Paris is the capital of France."
7	},
8	"index": 0,
9	"relevance_score": 0.98
10	}
11	],
12	"id": "gen-rerank-1234567890-abc",
13	"usage": {
14	"search_units": 1,
15	"total_tokens": 150
16	}
17	}