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

# Get brands

> Retrieve list of brands accessible to your API key



## OpenAPI

````yaml openapi.yaml get /get-brands
openapi: 3.0.0
info:
  title: Trakkr API
  description: Monitor your brand visibility and presence across AI models and prompts
  version: 1.0.0
  contact:
    name: Trakkr Support
    email: mack@trakkr.ai
    url: https://learn.trakkr.ai
  license:
    name: Proprietary
    url: https://trakkr.ai/
servers:
  - url: https://api.trakkr.ai
    description: Production server
security:
  - bearerAuth: []
paths:
  /get-brands:
    get:
      summary: Get brands
      description: Retrieve list of brands accessible to your API key
      operationId: getBrands
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BrandsResponse'
              examples:
                brands_list:
                  $ref: '#/components/examples/BrandsListResponse'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    BrandsResponse:
      type: object
      required:
        - brands
      properties:
        brands:
          type: array
          items:
            $ref: '#/components/schemas/Brand'
    Brand:
      type: object
      required:
        - id
        - name
      properties:
        id:
          type: string
          pattern: ^[0-9a-fx]{32}$
          description: Brand ID
          example: 0000000000000x000000000000000000
        name:
          type: string
          description: Brand name
          example: Acme Corporation
    Error:
      type: object
      required:
        - error
        - timestamp
      properties:
        error:
          type: string
          description: Error code
          example: INVALID_PARAMETER
        message:
          type: string
          description: Human-readable error message
          example: The 'brand' parameter is required
        errors:
          type: array
          description: Array of error messages (alternative to details)
          items:
            type: string
        details:
          type: array
          items:
            type: object
            properties:
              field:
                type: string
                description: Field that caused the error
              message:
                type: string
                description: Specific error message for this field
          description: Detailed error information
        timestamp:
          type: string
          format: date-time
          description: When the error occurred
          example: '2025-01-15T12:30:00Z'
        request_id:
          type: string
          description: Unique request identifier for debugging
          example: req_1234567890
  examples:
    BrandsListResponse:
      summary: List of accessible brands
      value:
        brands:
          - id: 0000000000000x000000000000000000
            name: Acme Corporation
          - id: 0000000000000x000000000000000001
            name: TechStart Inc
          - id: 0000000000000x000000000000000002
            name: Global Finance Co
  responses:
    Unauthorized:
      description: Unauthorized - Invalid or missing API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: UNAUTHORIZED
            message: Missing API key
            errors:
              - >-
                API key must be provided in the Authorization header as 'Bearer
                <api_key>'
            timestamp: '2025-01-15T12:30:00Z'
            request_id: req_1234567890
    Forbidden:
      description: Forbidden - Access denied to this resource
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: FORBIDDEN
            message: Invalid API key
            errors:
              - No accounts found for this API key
            timestamp: '2025-01-15T12:30:00Z'
            request_id: req_1234567890
    TooManyRequests:
      description: Too Many Requests - Rate limit exceeded
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: RATE_LIMIT_EXCEEDED
            message: API rate limit exceeded. Please try again later.
            timestamp: '2025-01-15T12:30:00Z'
            request_id: req_1234567890
      headers:
        X-RateLimit-Limit:
          description: The rate limit for the endpoint
          schema:
            type: integer
          example: 100
        X-RateLimit-Remaining:
          description: The number of requests remaining
          schema:
            type: integer
          example: 0
        X-RateLimit-Reset:
          description: Unix timestamp when the rate limit resets
          schema:
            type: integer
          example: 1736947800
    InternalServerError:
      description: Internal Server Error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: INTERNAL_ERROR
            message: An unexpected error occurred
            errors:
              - 'An unexpected error occurred: Database connection failed'
            timestamp: '2025-01-15T12:30:00Z'
            request_id: req_1234567890
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >
        API key authentication. Include your API key in the Authorization
        header:

        `Authorization: Bearer YOUR_API_KEY`

````