---
title: "List recent API documents"
method: GET
path: "/v1/documents"
tags: ["documents"]
---

# List recent API documents

`GET /v1/documents`

## Request

- Base URL: `https://www.polytranslator.com/api`
- URL: `https://www.polytranslator.com/api/v1/documents`
- Auth: HTTP bearer

## Query parameters

- `limit` integer

## Response `200`

Successful Response

- DocumentV1List
  - `object` 'list'
  - `data` DocumentV1[], required
    - `id` string, required
    - `object` 'document'
    - `status` 'queued' | 'processing' | 'completed' | 'failed' | 'canceled', required
    - `filename` string, required
    - `format` string, required
    - `src` string, required
    - `tgt` string, required
    - `tier` string, required
    - `output` string, required
    - `progress` DocumentV1Progress, required
      - `done` integer, required
      - `total` integer, required
      - `phase` 'read' | 'translate', nullable
    - `credits` DocumentV1Credits, required
      - `reserved` integer, required
      - `charged` integer, nullable, required
      - `refunded` integer, required
    - `created_at` string, date-time, required
    - `completed_at` string, date-time, nullable, required
    - `error` DocumentV1Error, required
      - `code` string, required
      - `message` string, required
    - `files` DocumentV1Files, required
      - `document` string, required
      - `pdf` string, required
    - `partial` boolean, required

## Other responses

- `422`: Validation Error

---

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