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

# List Brand Standards



## OpenAPI

````yaml /openapi.json get /v1/workspaces/{workspaceId}/brand-standards
openapi: 3.1.0
info:
  title: Specurate API
  description: ''
  version: 1.0.0
  contact: {}
servers:
  - url: https://app.specurate.com/api
    description: API Server
security: []
tags: []
paths:
  /v1/workspaces/{workspaceId}/brand-standards:
    get:
      tags:
        - Brand Standards
      summary: List Brand Standards
      operationId: BrandStandardsController_findAll_v1
      parameters:
        - name: workspaceId
          required: true
          in: path
          schema:
            type: string
        - name: status
          required: false
          in: query
          schema:
            type: string
            enum:
              - draft
              - new_from_project
              - new_from_collection
              - ready_to_use
        - name: cursor
          required: false
          in: query
          schema:
            type: string
        - name: limit
          required: false
          in: query
          schema:
            minimum: 1
            maximum: 100
            default: 20
            type: number
        - name: categoryId
          required: false
          in: query
          schema:
            type: string
            pattern: ^\d+$
        - name: search
          required: false
          in: query
          schema:
            type: string
            maxLength: 255
        - name: sortBy
          required: false
          in: query
          schema:
            default: createdAt
            type: string
            enum:
              - createdAt
              - position
              - refNumber
        - name: sortOrder
          required: false
          in: query
          schema:
            default: desc
            type: string
            enum:
              - asc
              - desc
        - name: filter
          required: false
          in: query
          schema:
            type: object
            additionalProperties: true
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BrandStandardListResponseDto'
        '400':
          description: Invalid Brand Standards list query.
        '401':
          description: Bearer authentication is missing or invalid.
        '403':
          description: Caller lacks the brand_standard seat.
      security:
        - bearer: []
components:
  schemas:
    BrandStandardListResponseDto:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/BrandStandardResponseDto'
        nextCursor:
          type: string
          nullable: true
        hasMore:
          type: boolean
        totalItems:
          type: number
      required:
        - items
        - nextCursor
        - hasMore
        - totalItems
    BrandStandardResponseDto:
      type: object
      properties:
        id:
          type: string
        refNumber:
          type: string
        name:
          type: string
        categoryId:
          type: string
        categoryName:
          type: string
        templateFamilyId:
          type: string
        familyCode:
          type: string
          nullable: true
        productTypeId:
          type: string
          nullable: true
        productTypeName:
          type: string
          nullable: true
        columnsAttributes:
          type: object
          additionalProperties: true
        templateFamilyColumnsAttributes:
          type: object
          additionalProperties: true
        status:
          type: string
          enum:
            - draft
            - new_from_project
            - new_from_collection
            - ready_to_use
        templateFamilyVersion:
          type: number
        itemsCount:
          type: number
        materialsCount:
          type: number
        partsCount:
          type: number
        componentsCount:
          type: number
        linkedItemsCount:
          type: number
        lastLinkedAt:
          type: string
          nullable: true
        projectsCount:
          type: number
        projectNames:
          type: array
          items:
            type: string
        collectionsCount:
          type: number
        collectionNames:
          type: array
          items:
            type: string
        lastUsedProjectName:
          type: string
          nullable: true
        position:
          type: number
        version:
          type: number
        createdAt:
          type: string
        updatedAt:
          type: string
        deletedAt:
          type: string
          nullable: true
      required:
        - id
        - refNumber
        - name
        - categoryId
        - categoryName
        - templateFamilyId
        - productTypeId
        - productTypeName
        - columnsAttributes
        - templateFamilyColumnsAttributes
        - status
        - templateFamilyVersion
        - itemsCount
        - materialsCount
        - partsCount
        - componentsCount
        - linkedItemsCount
        - lastLinkedAt
        - projectsCount
        - projectNames
        - collectionsCount
        - collectionNames
        - lastUsedProjectName
        - position
        - version
        - createdAt
        - updatedAt
        - deletedAt
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http

````