---
title: "List collections"
method: GET
path: "/hub/collections"
tags: ["Collections"]
---

# List collections

`GET /hub/collections`

## Request

- Base URL: `https://api.quiva.ai`
- URL: `https://api.quiva.ai/hub/collections`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/quivaworks/apis/quiva-ai-gateway-3/docs/hub/collections/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves a list of collections

## Query parameters

- `collection_type` 'node' | 'workflow'

## Response `200`

Collection retrieved successfully

- object
  - `results` object, required
    - `results` GetCollectionResponse[]: Array of results
      - `name` string, required: Name of the collection
      - `collection_type` string: Type of the collection (node or workflow)
      - `topic` string, required: Hash of the collection name
      - `description` string: Description of the collection
      - `subject` string, required: Subject identifier for the collection
      - `sequence` integer, required: The sequence number of the last message for this collection on the stream
      - `modified` integer, required: Timestamp of last modification
      - `type` 'created' | 'updated', required: Last event type - created or updated
    - `results_total` integer: Number of results

## Other responses

- `400`: Bad request

## Changes

- **2026-11-12** `8730377687f9`: 1 info
  - api operation id `getCollection` removed and replaced with `listCollections`
- **2025-06-06** `1d14b61a9537`: 6 warning, 1 info
  - removed the optional property `collection_type` from the response with the `200` status
  - removed the optional property `description` from the response with the `200` status
  - removed the optional property `modified` from the response with the `200` status
  - removed the optional property `name` from the response with the `200` status
  - …3 more

[Operation history](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway-3/changes/hub/collections/get.md)

---

[API](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway-3.md) - [All operations](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway-3/llms.txt) - [OpenAPI document](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway-3/revisions/f80cd5f3ac1c?raw)
