Tài liệu

Liệt kê tài liệu đã tạo

GET/generations

Các tài liệu đã tạo của không gian làm việc, mới nhất xếp trước. Các bộ lọc kết hợp bằng AND.

Tham số

Tên	Kiểu	Mô tả
`template`	uuid	Chỉ tài liệu được tạo từ mẫu này.
`created_by`	uuid	Chỉ tài liệu do người dùng này tạo.
`source`	app \| api	app cho tài liệu tạo trong PaperClerk, api cho API và trình kết nối MCP.
`from`	date-time	Chỉ tài liệu tạo tại hoặc sau thời điểm này. ISO 8601; chỉ ngày nghĩa là nửa đêm UTC.
`to`	date-time	Chỉ tài liệu tạo trước thời điểm này. Khoảng là nửa mở: from được tính, to thì không.
`search`	string	Chỉ tài liệu có tiêu đề chứa văn bản này.
`limit`	integer	Kích thước trang, từ 1 đến 200.
`cursor`	string	next_cursor của trang trước.

Yêu cầu

curl "https://usepaperclerk.com/api/v1/generations?template=4d1f0c2e-7b3a-4c1e-9d2f-1a2b3c4d5e6f&from=2026-09-01&limit=2" \
  -H "Authorization: Bearer pc_YOUR_TOKEN"

Phản hồi

JSON

{
  "generations": [
    {
      "id": "9b8e2f10-5c4d-4e3f-8a7b-6c5d4e3f2a1b",
      "template_id": "4d1f0c2e-7b3a-4c1e-9d2f-1a2b3c4d5e6f",
      "template_title": "Consulting invoice",
      "title": "Invoice — Maple & Fern, September",
      "generation_number": 13,
      "source": "api",
      "source_version": 3,
      "created_by": "7e6d5c4b-3a2f-4e1d-9c8b-7a6f5e4d3c2b",
      "created_by_name": "Mara Novak",
      "created_at": "2026-09-12T14:02:11.480Z",
      "pdf_status": "ready",
      "pdf_url": "https://usepaperclerk.com/api/v1/generations/9b8e2f10-5c4d-4e3f-8a7b-6c5d4e3f2a1b/pdf",
      "url": "https://usepaperclerk.com/app/generated/9b8e2f10-5c4d-4e3f-8a7b-6c5d4e3f2a1b"
    },
    { "…": "…" }
  ],
  "total": 27,
  "has_more": true,
  "next_cursor": "MjAyNi0wOS0xMlQxNDowMDowNS4wMDBafDliOGUyZjEw…"
}

template_id là null khi mẫu đã bị xóa; tài liệu và template_title vẫn còn.
Số thứ tự của tài liệu trong mẫu của nó; source_version là phiên bản đã lưu dùng để tạo.
next_cursor là null ở trang cuối.
total đếm mọi tài liệu khớp bộ lọc, bất kể kích thước trang.
created_by_name là tên hiển thị của người đó; null khi không gian làm việc không còn chia sẻ.