# List all categories in an ontology

Returns all categories with their bound metadata queries. Each metadata query includes binding properties that define how the key is used within the category (required status and unique index participation).

Endpoint: GET /accounts/{accountId}/ontologies/{ontologyId}/categories
Version: 1.0.0
Security: bearerAuth

## Path parameters:

  - `accountId` (string, required)
    Short account ID with scd- prefix
    Example: "scd-k2j8n4m1"

  - `ontologyId` (string, required)
    The ID of the ontology
    Example: "123e4567-e89b-12d3-a456-426614174001"

## Response 200 fields (application/json):

  - `id` (string, required)
    Example: "cat-123abc45"

  - `name` (string, required)
    Example: "Research Papers"

  - `description` (string, required)
    Example: "Academic research papers and publications"

  - `instructions` (string,null, required)
    Example: "Please ensure all papers include proper citations"

  - `ontologyId` (string, required)
    Example: "123e4567-e89b-12d3-a456-426614174001"

  - `boundMetadataQueries` (array, required)
    Metadata keys bound to this category with their binding properties

  - `boundMetadataQueries.dataType` (string, required)
    Enum: "STRING", "SHORT_STRING", "NUMBER", "BOOLEAN", "DATE"

  - `boundMetadataQueries.createdAt` (string, required)
    Example: "2024-01-15T10:30:00Z"

  - `boundMetadataQueries.updatedAt` (string,null, required)
    Example: "2024-01-15T14:30:00Z"

  - `boundMetadataQueries.binding` (object, required)
    Binding properties for this metadata query in this category

  - `boundMetadataQueries.binding.required` (boolean, required)
    Whether this metadata query is required for this category
    Example: true

  - `boundMetadataQueries.binding.uniqueIndexElement` (boolean, required)
    Whether this metadata query is part of the unique index for this category


## Response 401 fields

## Response 404 fields