Skip to main content
The Lokki API organizes rental items into a two-level hierarchy: Verticales and Categories. This structure helps users find products and services efficiently across different rental sectors.

​
Core Concepts

​
Verticales

Verticales represent the top-level sectors in the Lokki ecosystem. Each verticale defines a broad domain of rental activity. Examples of Verticales:
  • BIKE: All types of bicycles.
  • CAR: Cars, vans, and other road vehicles.
  • SKI: Winter sports equipment.
  • BOAT: Marine and watercraft.

​
Categories

Categories provide a more granular classification within each Verticale. Examples of Categories:
  • Under BIKE: Mountain Bike, Road Bike, City Bike, Electric Bike.
  • Under CAR: Convertible, SUV, Compact, Utility.

​
Available Endpoints

Get Verticales

Retrieve a list of all available top-level sectors (Verticales).

Get Categories

Retrieve a list of precise sub-sectors (Categories) with optional filtering by Verticale.

​
Data Structure

​
Verticale (VerticaleExternalDto)

A Verticale object contains its unique identifier and localized descriptive information.
  • id: The machine-readable identifier (e.g., BIKE, CAR).
  • infos: Contains the name and description of the verticale, localized based on the lang parameter.

​
Category (CategoryExternalDto)

A Category object provides details about a specific sub-sector.
  • id: Unique identifier for the category.
  • name: Localized name of the category.
  • verticale: The Verticale ID this category belongs to.
Once you have identified the appropriate Verticale or Category IDs, you can use them to filter stores and store items.

Store Items

Filter items using verticale and verticaleCategoryIds to find exactly what your customers need.