Skip to main content
GET
/
v1
/
collections
/
{id}
curl https://api.okrapdf.com/v1/collections/col-40da068481cf4f248853507cba6be611 \
  -H "Authorization: Bearer okra_YOUR_KEY"

​
Overview

Returns collection metadata along with the full list of member documents and their processing status.

​
Request

​
id
string
required
Collection ID (col-...) or collection name.
curl https://api.okrapdf.com/v1/collections/col-40da068481cf4f248853507cba6be611 \
  -H "Authorization: Bearer okra_YOUR_KEY"

​
Response (200)

{
  "id": "col-40da068481cf4f248853507cba6be611",
  "name": "Q4 Earnings",
  "description": "Quarterly earnings reports",
  "visibility": "private",
  "created_at": "2025-01-15T08:30:00Z",
  "document_count": 2,
  "documents": [
    {
      "id": "doc-abc123",
      "added_at": "2025-01-15T08:31:00Z",
      "file_name": "10k.pdf",
      "phase": "complete",
      "pages_total": 42,
      "total_nodes": 318,
      "source": "upload"
    }
  ]
}