bookhoard/docs/api/collections/list_collections.md

List Collections

Get all collections for the authenticated user.

Endpoint: GET /api/collections Auth: Required Content-Type: application/json

Query Parameters

Parameter	Type	Required	Description
limit	integer	No	Number of collections to return (default: 50)
offset	integer	No	Number of collections to skip (default: 0)

Response (200 OK)

{
  "collections": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Science Fiction",
      "description": "My sci-fi collection",
      "color": "#FF5733",
      "icon": "🚀",
      "auto_assign_rules": [
        {
          "field": "genre",
          "operator": "equals",
          "value": "Science Fiction",
          "priority": 1,
          "enabled": true
        }
      ],
      "view_settings": {
        "kobo": {
          "view_mode": "grid",
          "sort_order": "name",
          "items_per_page": 24
        }
      },
      "created_at": "2026-02-01T10:00:00Z"
    }
  ],
  "total": 1
}

Error Responses

Code	Description
401	Authentication required
500	Internal server error

Try It Out