List Collections

GET

https://api.captain.dev/v2/collections

GET

/v2/collections

import json
import requests
BASE_URL = "https://api.captain.dev"
API_KEY = "your_api_key"
headers = {
    "Authorization": f"Bearer {API_KEY}",
}
params = {
    "limit": 10,
    "offset": 0
}
response = requests.get(
    f"{BASE_URL}/v2/collections",
    headers=headers,
    params=params,
    timeout=30.0
)
print(json.dumps(response.json(), indent=2))

200Retrieved

{
  "collections": [
    {
      "collection_id": "db_9f8e7d6c5b4a3",
      "collection_name": "Marketing Assets",
      "created_at": "2024-05-20T10:15:30Z",
      "document_count": 245
    },
    {
      "collection_id": "db_2a7b4c9d8e1f0",
      "collection_name": "Customer Research",
      "created_at": "2024-06-03T16:42:11Z",
      "document_count": 87
    },
    {
      "collection_id": "db_6c5b4a3f2e1d0",
      "collection_name": "Legal Contracts",
      "created_at": "2024-07-12T09:05:44Z",
      "document_count": 412
    }
  ],
  "limit": 50,
  "offset": 0,
  "total_count": 1200
}

List collections for the authenticated organization with pagination.

Query parameters

limitintegerOptional1-1000Defaults to 100

offsetintegerOptional>=0Defaults to 0

Response

Successful Response

collectionslist of objects

limitinteger

offsetinteger

total_countinteger