> ## Documentation Index
> Fetch the complete documentation index at: https://docs.elkapi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Document Reranking
> - Rerank a list of documents by relevance to a query
```bash cURL theme={null} theme={null}
curl --request POST \
--url 'https://api.elkapi.com/v1/rerank' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data '{
"model": "jina-reranker-v2-base-multilingual",
"query": "query",
"documents": [
"document"
]
}'
```
```python Python theme={null} theme={null}
import requests
url = "https://api.elkapi.com/v1/rerank"
headers = {
"Authorization": "Bearer "
}
headers["Content-Type"] = "application/json"
payload = {
"model": "jina-reranker-v2-base-multilingual",
"query": "query",
"documents": [
"document"
]
}
response = requests.request("POST", url, headers=headers, json=payload)
print(response.json())
```
```javascript JavaScript theme={null} theme={null}
const url = "https://api.elkapi.com/v1/rerank";
const headers = {
"Authorization": "Bearer "
};
headers["Content-Type"] = "application/json";
const payload = {
"model": "jina-reranker-v2-base-multilingual",
"query": "query",
"documents": [
"document"
]
};
const response = await fetch(url, {
method: "POST",
headers,
body: JSON.stringify(payload)
});
console.log(await response.json());
```
```json 200 theme={null} theme={null}
{
"id": "id",
"results": [
{
"index": 1,
"relevance_score": 1,
"document": {}
}
],
"meta": {}
}
```
## Authorizations
All endpoints require Bearer Token authentication.
Add it to the request headers:
```
Authorization: Bearer YOUR_API_KEY
```
## Body
Example: `jina-reranker-v2-base-multilingual`
Query text
List of documents to rerank
Return the top N results
## Response