---
title: "Stream RLHF preference data as newline-delimited JSON"
method: GET
path: "/api/v1/exports/rlhf/{ranking_id}.jsonl"
tags: ["Exports"]
---

# Stream RLHF preference data as newline-delimited JSON

`GET /api/v1/exports/rlhf/{ranking_id}.jsonl`

## Request

- Base URL: `https://app.aimrank.io` (the document declares no server; this is the origin it was published from)
- URL: `https://app.aimrank.io/api/v1/exports/rlhf/{ranking_id}.jsonl`
- Auth: API key in header `X-API-Key`

Stream a ranking's preference data as JSONL (one record per line).

Drop-in compatible with `datasets.load_dataset("json", data_files=URL)`
and `trl`'s preference dataset loaders. Owner-only.

Format options match POST /exports/rlhf:
- `dpo` — DPO chosen/rejected pair format
- `anthropic_hh` — Anthropic Helpful-Harmless format
- `openai_rm` — OpenAI Reward Model format
- `aimrank_full` — full metadata (rating before/after, voter segment,
  decision time)

Auth: API key OR JWT, Pro plan or higher, and must own the ranking.

## Path parameters

- `ranking_id` string, required

## Query parameters

- `format` 'anthropic_hh' | 'openai_rm' | 'dpo' | 'aimrank_full'
- `min_confidence` number
- `include_llm_votes` boolean

## Response `200`

Successful Response

## Other responses

- `422`: Validation Error

---

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