---
title: "Poll successful render completions"
method: GET
path: "/render/completions"
---

# Poll successful render completions

`GET /render/completions`

## Request

- Base URL: `https://rendry.io/api/v1`
- URL: `https://rendry.io/api/v1/render/completions`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer

Read-only account-scoped completion events, deduplicated by stable job ID. Newest-first by default, continue older history with before=next_cursor. To consume new events in commit order, use after=0 then after=the last item cursor; continue each full page before advancing. Older jobs that finish later appear as new events. Exact charges come from recorded debits. Events survive for the same retention as job status records. This is a polling feed; consumers deduplicate IDs after retries.

## Query parameters

- `after` string
- `before` string
- `job_id` string
- `limit` integer

## Headers

- `X-Rendry-Account` string

## Response `200`

Success

- object
  - `items` RenderCompletion[], required
    - `id` string, required: Stable job id for platform deduplication.
    - `job_id` string, required
    - `cursor` string, required: Commit-ordered completion cursor. Keep as a string.
    - `url` string, uri, required
    - `preset_id` string
    - `format` string, required
    - `page_count` integer, required
    - `completed_at` string, date-time, required
    - `credits_charged` number, required: Actual successful ledger debit, including preview pricing when applicable. Never estimated from the current template.
    - `page_previews` PagePreview[]: Stored pictures of the PDF pages requested by this render. Empty when none are available; page_preview_status names the requested and missing pages.
      - `page` integer: 1-based page number of the document.
      - `url` string: URL of the stored picture (image/jpeg).
      - `width` integer: Pixel width of the picture as stored, not of the pdf page.
      - `height` integer
    - `page_preview_status` PagePreviewStatus: The requested PDF page pictures and their current storage availability. pending means one or more pictures are unavailable now, including older jobs that never uploaded them; it does not promise a future upload. Re-read status to refresh without rendering or charging again.
      - `status` 'pending' | 'ready', required
      - `requested_pages` integer[], required
      - `available_pages` integer[], required
      - `missing_pages` integer[], required
    - `print_receipt` PDFPrintReceipt: Protected receipt bound to the exact uploaded and owner-downloadable final PDF bytes and immutable APTEC profile. Exposed only for the selected done attempt; omitted for ordinary/historical RGB results. This receipt makes no PDF/X certification claim.
      - `version` 1, required
      - `profile` 'aptec-offset-coated-linearctv-2025-v1', required
      - `profile_sha256` '2a0a26387276046dc129d4330a7a45542b736c8640e3ec4cb74df809c5ccfb0e', required
      - `sha256` string, required
      - `color_space` 'CMYK', required
      - `intent` 'relative-colorimetric', required
      - `black_point_compensation` true, required
      - `preflight` PDFPrintPreflight, required: Counts from independent inspection of the actual final CMYK PDF resource graph; effective raster placement resolution is checked against the product print DPI. Low resolution is reported, not silently upsampled.
        - `pages` integer, required
        - `images` integer, required
        - `shadings` integer, required
        - `painted_streams` integer, required
        - `raster_below_300_dpi` integer, required
        - `minimum_dpi` number
    - `expires_at` string, date-time: Server-owned file deadline: authenticated live/test output expires 365 days after completion; guests expire 72 hours after batch creation.
  - `next_cursor` string: Last item cursor when the page is full; absent at the end.

## Other responses

- `400`: Invalid cursor or page limit
- `401`: Missing or invalid credential
- `404`: No template in this account

---

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