> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vectoraidb.actian.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List all collections

> Get a list of all existing collection names in the database. Use `GET /collections/{collection_name}` to get detailed information about a specific collection.



## OpenAPI

````yaml get /collections
openapi: 3.0.3
info:
  title: Actian VectorAI DB - Collections API
  description: Collection management API for Actian VectorAI DB.
  version: 1.0.0
  contact:
    name: Actian Corporation
    url: https://www.actian.com
servers:
  - url: http://localhost:6573
    description: Local development server (REST API)
  - url: https://api.vectorai.actian.com
    description: Production server
security:
  - bearerAuth: []
tags:
  - name: Collections
    description: Collection lifecycle management operations
paths:
  /collections:
    get:
      tags:
        - Collections
      summary: List all collections
      description: >-
        Get a list of all existing collection names in the database. Use `GET
        /collections/{collection_name}` to get detailed information about a
        specific collection.
      operationId: list_collections
      responses:
        '200':
          description: List of collection names
          content:
            application/json:
              schema:
                type: object
                properties:
                  usage:
                    type: object
                    properties:
                      hardware:
                        type: object
                        nullable: true
                        description: >-
                          Hardware resource counters for the operation,
                          including CPU, payload I/O, payload index I/O, and
                          vector I/O metrics.
                  time:
                    type: number
                    format: double
                    example: 0.000150269
                    description: Time spent to process this request, in seconds.
                  status:
                    type: string
                    example: ok
                    description: Operation status.
                  result:
                    type: object
                    properties:
                      collections:
                        type: array
                        items:
                          type: object
                          properties:
                            name:
                              type: string
                              example: my_collection
                              description: The name of the collection.
              examples:
                success:
                  value:
                    usage:
                      hardware: null
                    time: 0.000150269
                    status: ok
                    result:
                      collections:
                        - name: my_hnsw_collection
                        - name: my_collection
        default:
          description: Error response
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: object
                    properties:
                      error:
                        type: string
                  time:
                    type: number
                    format: double
                    description: Time spent to process this request, in seconds.
      x-codeSamples:
        - lang: Python
          label: List collections
          source: |
            from actian_vectorai_client import VectorAIClient

            with VectorAIClient("localhost:6574") as client:
                # List all collections
                collections = client.collections.list()
                
                print(f"Found {len(collections)} collections:")
                for name in collections:
                    print(f"  • {name}")
        - lang: JavaScript
          label: List collections
          source: >
            import { VectorAIClient } from '@actian/vectorai-client';


            const client = new VectorAIClient('localhost:6574');


            const collections = await client.collections.list();

            console.log(`Found ${collections.length} collections:`,
            collections);


            client.close();
        - lang: cURL
          label: List collections
          source: |
            curl -X GET "http://localhost:6573/collections" \
              -H "Accept: application/json" \
              -H 'Authorization: Bearer <admin-jwt-or-access-token>'
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Admin JWT or access token for authenticating requests to VectorAI DB.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.