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

# Get Categories

Retrieve a list of categories. You can filter categories by Verticale using the `verticale.equals` or `verticale.in` query parameters.


## OpenAPI

````yaml GET /v2/external/verticales/categories
openapi: 3.1.0
info:
  title: Lokki API
  description: API documentation for Lokki, a rental management application.
  license:
    name: MIT
  version: '2.0'
servers:
  - url: https://staging.api.eu-west-3.lokki.rent
  - url: https://prod.api.eu-west-3.getlokki.com
security:
  - x-access-token: []
paths:
  /v2/external/verticales/categories:
    get:
      operationId: external__getManyCategories
      parameters:
        - name: skip
          required: false
          in: query
          description: Number of documents to skip
          schema:
            minimum: 0
            default: 0
            type: number
        - name: limit
          required: false
          in: query
          description: Maximum number of documents to return
          schema:
            minimum: 0
            maximum: 100
            default: 100
            type: number
        - name: sort
          required: false
          in: query
          schema:
            oneOf:
              - type: array
                items:
                  type: string
              - type: string
          description: >-
            Sort order for the results. Use '__asc' or '__desc' suffix to
            specify ascending or descending order respectively. Example:
            'name__asc'
        - name: fields
          required: false
          in: query
          schema:
            oneOf:
              - type: array
                items:
                  type: string
              - type: string
          description: Fields to include in the response
        - name: verticale.in
          required: false
          in: query
          schema:
            oneOf:
              - type: array
                items:
                  type: string
              - type: string
          description: Filter entries that match any of the specified values
        - name: verticale.notIn
          required: false
          in: query
          schema:
            oneOf:
              - type: array
                items:
                  type: string
              - type: string
          description: Filter entries that do not match any of the specified values
        - name: verticale.equals
          required: false
          in: query
          description: Filter entries that have a specific value
          schema:
            type: string
        - name: verticale.notEquals
          required: false
          in: query
          description: Filter entries that do not have a specific value
          schema:
            type: string
        - name: lang
          required: false
          in: query
          description: Language for localized content
          example: fr
          schema:
            type: string
            enum:
              - fr
              - en
              - nl
              - de
              - it
              - pt
              - es
              - pl
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetManyCategoriesResponseDto'
components:
  schemas:
    GetManyCategoriesResponseDto:
      type: object
      properties:
        total:
          type: number
          description: Total number of categories matching the query
          minimum: 0
          example: 10
        docs:
          description: List of categories matching the query
          type: array
          items:
            $ref: '#/components/schemas/CategoryExternalDto'
      required:
        - total
        - docs
    CategoryExternalDto:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the category
          example: 61e7b8f9e4b0c8a1d4f3c2b1
        infos:
          description: Descriptive information about the category
          allOf:
            - $ref: '#/components/schemas/CategoryExternalInfos'
        meta:
          description: Metadata flags for the category
          allOf:
            - $ref: '#/components/schemas/CategoryExternalMeta'
      required:
        - id
        - infos
        - meta
    CategoryExternalInfos:
      type: object
      properties:
        name:
          type: string
          description: Localized name of the category
          example: Mountain Bike
        verticale:
          description: Information about the parent verticale
          allOf:
            - $ref: '#/components/schemas/CategoryExternalVerticaleInfos'
      required:
        - name
        - verticale
    CategoryExternalMeta:
      type: object
      properties:
        isOptions:
          type: boolean
          description: True if this category is for accessories/options
          example: false
        isDefault:
          type: boolean
          description: True if this is the default category for the verticale
          example: true
      required:
        - isOptions
        - isDefault
    CategoryExternalVerticaleInfos:
      type: object
      properties:
        id:
          enum:
            - BIKE
            - ELECTRIC_BIKE
            - MOPED
            - MOTORCYCLE
            - CAR
            - SCOOTER
            - SKI
            - CLIMBING
            - SNOWSHOES
            - SURF
            - PADDLE
            - CANOE_KAYAK
            - BOAT
            - EVENT
            - MOTOCULTURE
            - TOOLING
          type: string
          description: Identifier of the verticale
          example: BIKE
        name:
          type: string
          description: Localized name of the verticale
          example: Vélo
      required:
        - id
        - name
  securitySchemes:
    x-access-token:
      type: apiKey
      in: header
      name: x-access-token

````