# List conversions

> Newest first, ordered by creation time then ID.

See [conversion formats and limits](https://revise.io/developer/docs/revise-api/conversions) for integration guidance.

## TypeScript

```ts
import { ReviseClient } from "@reviseio/api";

const revise = new ReviseClient({ apiKey: process.env.REVISE_API_KEY! });
const result = await revise.conversions.list({ limit: 20 });
```

`GET https://revise.io/api/v1/convert`

Newest first, ordered by creation time then ID. Pass next_cursor with the same status filter for the next page; null means the end. Only status, limit, and cursor are supported. Cursors belong to the authenticated account.

## Authorization

`Authorization: Bearer <key>` with an API key from https://revise.io/console/api-keys.

## Query parameters

- `limit` (integer): min 1. max 100
- `cursor` (string)
- `status` (string): one of "queued", "running", "succeeded", "failed", "cancelled"

## Responses

### 200 `object`

Conversion page

- `data` (array<Conversion>, required)
  - `id` (string, required)
  - `object` (string, required): always "conversion"
  - `status` (string, required): one of "queued", "running", "succeeded", "failed", "cancelled"
  - `mode` (string, required): Empty after request content has been deleted.. one of "deterministic", "vision", ""
  - `input` (object, required)
    - `file_id` (string, required)
    - `format` (string, required): Empty after request content has been deleted.. one of "pdf", "docx", "md", "html", "txt", "rtf", "odt", "image", ""
    - `filename` (string, required)
    - `bytes` (integer, required)
    - `sha256` (string, required)
  - `output` (object, required)
    - `format` (string, required): Empty after request content has been deleted.. one of "docx", "pdf", "md", "html", "txt", ""
    - `artifact` (Artifact | null, required)
  - `output_encrypted` (boolean, required)
  - `metadata` (Metadata, required): Up to 16 string values for application attribution. Keys are 1–64 UTF-8 bytes; values at most 512 UTF-8 bytes. Metadata is deleted with request content; persist your own job mapping for long-term attribution.. example {"customer":"acme","environment":"production"}
  - `usage` (Usage | null, required)
  - `created_at` (string<date-time>, required)
  - `completed_at` (string | null, required)
  - `content_expires_at` (string | null, required)
  - `content_deleted_at` (string | null, required)
  - `error` (object | null, required)
  - `retention` (RetentionOptions)
    - `delete_after_webhook_id` (string, required): Account-owned endpoint subscribed to prompt.completed or conversion.completed, matching the request kind. Its successful acknowledgement deletes request content and ephemeral source. Download everything before returning 2xx.
- `next_cursor` (string | null, required)

### default `Error`

Error

- `error` (object, required)
  - `code` (string, required)
  - `message` (string, required)
  - `details` (object)
