---
title: "Your library as pictures: results or uploads with thumbnail, file and source links (valid 7 days)"
method: GET
path: "/api/v1/library"
tags: ["Jobs"]
---

# Your library as pictures: results or uploads with thumbnail, file and source links (valid 7 days)

`GET /api/v1/library`

## Request

- Base URL: `https://pixly.app`
- URL: `https://pixly.app/api/v1/library`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://pixly.app/oauth/authorize`, token URL `https://pixly.app/api/oauth/token`, scopes: `tools`)

## Query parameters

- `limit` integer
- `type` 'images' | 'videos' | 'uploads'
- `locale` 'en' | 'es' | 'pt' | 'de' | 'fr' | 'it' | 'pl' | 'cs'
- `before` string, date-time

## Response `200`

Newest first. Pass an item's r2Path to any tool to run it on that picture.

- object
  - `nextBefore` string: Present when the page is full: pass as before for older items.
  - `items` object[]
    - `id` string, required
    - `kind` 'image' | 'video' | 'upload', required
    - `title` string, required
    - `made` string: What made it, as a stable key: a job intent ("sky_replace"), "staging", "video" or "upload".
    - `status` 'completed' | 'processing' | 'failed', required
    - `createdAt` string
    - `thumbUrl` string
    - `url` string
    - `r2Path` string
    - `sourceUrl` string
    - `sourceR2Path` string
    - `style` string

## Other responses

- `401`: Missing/invalid credential
- `422`: Invalid input — error.issues lists the offending fields
- `429`: Rate limited — see Retry-After (120 req/min, 30/min for generations)

---

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