Lokki

Lokki Catalogue API

The Catalogue API from Lokki — 5 operation(s) for catalogue.

GitHub OpenAPI

Operations 5

GET /v2/catalogue/getCatalogueOverview #
POST /v2/catalogue/update-item-order #
POST /v2/catalogue/generation/item-translations #
GET /v2/catalogue/predictions/categories #
POST /v2/catalogue/generation/product-description #

Documentation

📖
Documentation
https://docs.getlokki.com/
📖
APIReference
https://docs.getlokki.com/api-reference/getting-started
📖
GettingStarted
https://docs.getlokki.com/api-reference/getting-started
📖
Authentication
https://docs.getlokki.com/api-reference/authentication
📖
Documentation
https://prod.api.eu-west-3.lokki.rent/v2/api

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/lokki/refs/heads/main/openapi/lokki-catalogue-api-openapi.yml

Other Resources

🔗
Deprecation
https://docs.getlokki.com/api-reference/stores/deprecations
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/lokki/refs/heads/main/data-model/lokki-data-model.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/lokki/refs/heads/main/errors/lokki-problem-types.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/lokki-catalogue-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

lokki-catalogue-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Lokki Catalogue API
  description: The main API powering the Lokki Dashboard and Online Store
  version: '2.0'
  contact: {}
servers: []
security:
- x-access-token: []
tags:
- name: Catalogue
paths:
  /v2/catalogue/getCatalogueOverview:
    get:
      operationId: getCatalogueOverview
      parameters: []
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CatalogueOverviewDto'
      tags:
      - Catalogue
  /v2/catalogue/update-item-order:
    post:
      operationId: updateItemOrder
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateItemOrderDto'
      responses:
        '201':
          description: ''
      tags:
      - Catalogue
  /v2/catalogue/generation/item-translations:
    post:
      operationId: generateItemTranslations
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GenerateItemTranslationsDto'
      responses:
        '201':
          description: ''
      tags:
      - Catalogue
  /v2/catalogue/predictions/categories:
    get:
      operationId: getCategoryPredictions
      parameters:
      - name: productName
        required: true
        in: query
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductVerticaleCategoryListDto'
      tags:
      - Catalogue
  /v2/catalogue/generation/product-description:
    post:
      operationId: generateProductDescription
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GenerateProductDescriptionDto'
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductDescriptionProposalDto'
      tags:
      - Catalogue
components:
  schemas:
    ProductDescriptionProposalDto:
      type: object
      properties:
        description:
          type: string
        language:
          enum:
          - fr
          - en
          - nl
          - de
          - it
          - pt
          - es
          - pl
          type: string
      required:
      - description
      - language
    GenerateItemTranslationsDto:
      type: object
      properties:
        itemId:
          type: string
        itemType:
          enum:
          - PRODUCT
          - SERVICE
          - PACK
          type: string
      required:
      - itemId
      - itemType
    CatalogueOverviewDto:
      type: object
      properties:
        lcd:
          $ref: '#/components/schemas/CatalogueBodyDto'
        lld:
          $ref: '#/components/schemas/CatalogueBodyDto'
      required:
      - lcd
      - lld
    NotAvailableRange:
      type: object
      properties:
        from:
          format: date-time
          type: string
        to:
          format: date-time
          type: string
      required:
      - from
      - to
    ProductVerticaleCategoryListDto:
      type: object
      properties:
        productVerticaleCategories:
          type: array
          items:
            $ref: '#/components/schemas/ProductVerticaleCategory'
      required:
      - productVerticaleCategories
    CatalogueBodyDto:
      type: object
      properties:
        packCategory:
          $ref: '#/components/schemas/CataloguePackCategoryDto'
        categories:
          type: array
          items:
            $ref: '#/components/schemas/CatalogueCategoryDto'
      required:
      - packCategory
      - categories
    CatalogueSubProductDto:
      type: object
      properties:
        id:
          type: string
        serialNumber:
          type: string
        isAvailable:
          type: boolean
        notAvailableRanges:
          type: array
          items:
            $ref: '#/components/schemas/NotAvailableRange'
      required:
      - id
      - notAvailableRanges
    ProductVerticaleCategory:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        i18nKey:
          type: string
        verticale:
          enum:
          - BIKE
          - ELECTRIC_BIKE
          - MOPED
          - MOTORCYCLE
          - CAR
          - SCOOTER
          - SKI
          - CLIMBING
          - SNOWSHOES
          - SURF
          - PADDLE
          - CANOE_KAYAK
          - BOAT
          - EVENT
          - MOTOCULTURE
          - TOOLING
          type: string
        rank:
          type: number
        isDefault:
          type: boolean
        isOptions:
          type: boolean
        hasChildItems:
          type: boolean
        attributes:
          type: array
          items:
            $ref: '#/components/schemas/ProductVerticalCategoryAttribute'
        newAttributes:
          type: array
          items:
            $ref: '#/components/schemas/ProductVerticalCategoryAttribute'
        newName:
          type: string
        legacy:
          type: boolean
        createdAt:
          format: date-time
          type: string
        updatedAt:
          format: date-time
          type: string
      required:
      - id
      - name
      - i18nKey
      - verticale
      - rank
      - isDefault
      - isOptions
      - hasChildItems
      - attributes
      - createdAt
      - updatedAt
    ProductAttributeDto:
      type: object
      properties:
        attribute:
          type: string
        tags:
          type: array
          items:
            type: string
      required:
      - attribute
      - tags
    ProductVerticalCategoryAttribute:
      type: object
      properties:
        attribute:
          type: string
        tags:
          type: array
          items:
            type: string
        mandatory:
          type: boolean
      required:
      - attribute
      - tags
      - mandatory
    GenerateProductDto:
      type: object
      properties:
        name:
          type: string
        vertical:
          type: string
        category:
          type: string
        attributes:
          type: array
          items:
            $ref: '#/components/schemas/ProductAttributeDto'
      required:
      - name
      - vertical
      - category
      - attributes
    ItemToUpdateOrderDto:
      type: object
      properties:
        id:
          type: string
        type:
          type: string
          enum:
          - PRODUCT
          - SERVICE
          - PACK
        rank:
          type: number
      required:
      - id
      - type
      - rank
    CatalogueItemDto:
      type: object
      properties:
        id:
          type: string
        type:
          type: string
          enum:
          - PRODUCT
          - SERVICE
          - PACK_CATEGORY
          - PACK_PRODUCT
        name:
          type: string
        hasInsurance:
          type: boolean
        isAvailable:
          type: boolean
        quantity:
          type: number
        imageUrl:
          type: string
        subProducts:
          type: array
          items:
            $ref: '#/components/schemas/CatalogueSubProductDto'
        displaySubProducts:
          type: boolean
        translationInProgress:
          type: boolean
        verticalCategoryId:
          type: string
      required:
      - id
      - type
      - name
      - imageUrl
      - displaySubProducts
    CataloguePackCategoryDto:
      type: object
      properties:
        packs:
          type: array
          items:
            $ref: '#/components/schemas/CatalogueItemDto'
      required:
      - packs
    GenerateProductDescriptionDto:
      type: object
      properties:
        language:
          enum:
          - fr
          - en
          - nl
          - de
          - it
          - pt
          - es
          - pl
          type: string
        product:
          $ref: '#/components/schemas/GenerateProductDto'
      required:
      - language
      - product
    UpdateItemOrderDto:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/ItemToUpdateOrderDto'
      required:
      - items
    CatalogueCategoryDto:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        items:
          type: array
          items:
            $ref: '#/components/schemas/CatalogueItemDto'
      required:
      - id
      - name
      - items
  securitySchemes:
    x-access-token:
      scheme: bearer
      bearerFormat: JWT
      type: apiKey
      in: header
      name: x-access-token