List Collections

List collection IDs inside a database.

GET /databases/collections

Python SDK

response = client.databases.collections(database="my_first_database")

Success

{
  "success": true,
  "data": {
    "collections": ["user_alex", "user_johndoe", "workspace_42", "collection_default_abc123"],
    "message": "Successfully retrieved collection IDs"
  },
  "error": null,
  "meta": {
    "request_id": "9d13aef4-02f4-4e73-8c62-4c2601d04f9d",
    "latency_ms": 12.3
  }
}

Collections are created by writing to them. A new database has none: the first ingest without a collection creates the default collection, and the first ingest under a new collection value creates that one. The list grows as your application writes.

Python SDK

response = client.databases.collections(database="my_first_database")

Success

{
  "success": true,
  "data": {
    "collections": ["user_alex", "user_johndoe", "workspace_42", "collection_default_abc123"],
    "message": "Successfully retrieved collection IDs"
  },
  "error": null,
  "meta": {
    "request_id": "9d13aef4-02f4-4e73-8c62-4c2601d04f9d",
    "latency_ms": 12.3
  }
}

Related Resources

• Inspect content: List Documents, scoped to a collection
• Delete a collection: Delete Collection
• Inspect usage: Database Stats

Authorizations

Authorization · string · header · required

API key sent as a Bearer token: "Bearer prefix.secret"

Query Parameters

database · string · required

Database identifier

Example:

"acme_corp"

Response

200

application/json

OK

data · object

Show child attributes

Example:

{
  "collections": ["team_docs", "engineering"],
  "message": "Success",
  "sub_tenant_ids": ["sub_tenant_4567", "sub_tenant_8901"]
}

error · object | null

Null on success; an object with code and message on failure.

Show child attributes

Example:

null

meta · object

Show child attributes

Example:

{
  "collection": "team_docs",
  "database": "acme_corp",
  "latency_ms": 12.3,
  "request_id": "9d13aef4-02f4-4e73-8c62-4c2601d04f9d",
  "source_type": "file",
  "sub_tenant_id": "team_docs",
  "tenant_id": "acme_corp"
}

success · boolean

Whether the request succeeded.

Example:

true