kubova-com API

openapi: 3.1.0
info:
  title: kubova-com API
  version: '2026-10-30'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-30: 4 operation(s) read from 1 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; kubova-com has published no machine-readable contract that the
    pipeline could find. Engine: anthropic.'
  x-evidence-tiers:
    code-example: 2
    documentation: 2
    pages-with-code: 1
    pages-read: 1
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-30'
  x-generator: generate-contract-from-docs.py
  x-engine: anthropic
  x-sources:
  - https://kubova.com/en/docs/api
paths:
  /api/v1/me:
    get:
      operationId: get_api_v1_me
      tags:
      - Api
      summary: Verify a key is valid before sending pack requests.
      x-source: https://kubova.com/en/docs/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    post:
      operationId: post_api_v1_me
      tags:
      - Api
      summary: POST /api/v1/me
      x-source: https://kubova.com/en/docs/api
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1MeRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://kubova.com/api/v1/me  -H \"Authorization: Bearer kbv_...\" Pack containers POST to /api/v1/pack with cargos and\
          \ a container. The packer returns placements per container, used volume, and any unplaced pieces. curl -X POST https://kubova.com/api/v1/pack\
          \  -H \"Authorization: Bearer kbv_...\"  -H \"Content-Type: application/json\"  -d '{\n \"cargos\": [{\n \"id\": \"sku-a\",\n \"name\"\
          : \"Box A\",\n \"shape\":"
  /api/v1/pack:
    post:
      operationId: post_api_v1_pack
      tags:
      - Api
      summary: Pack containers from cargos and return placements per container, used volume, and any unplaced pieces.
      x-source: https://kubova.com/en/docs/api
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1PackRequest'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1PackResponse'
      x-evidence:
        kind: documentation
  /api/v1/report:
    post:
      operationId: post_api_v1_report
      tags:
      - Api
      summary: POST /api/v1/report
      x-source: https://kubova.com/en/docs/api
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1ReportRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -X POST https://kubova.com/api/v1/report  -H "Authorization: Bearer kbv_..."  -H "Content-Type: application/json"  -d ''{
          "cargos": [...], "container": {...}, "format": "json" }'''
components:
  schemas:
    PostApiV1MeRequest:
      type: object
      properties:
        cargos:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              name:
                type: string
              shape:
                type: string
              lengthCm:
                type: integer
              widthCm:
                type: integer
              heightCm:
                type: integer
              quantity:
                type: integer
              weightKg:
                type: integer
              color:
                type: string
              includeInLoading:
                type: boolean
              allowStacking:
                type: boolean
              allowRotation:
                type: boolean
        container:
          type: object
          properties:
            id:
              type: string
            name:
              type: string
            innerLengthCm:
              type: number
            innerWidthCm:
              type: number
            innerHeightCm:
              type: number
            doorWidthCm:
              type: integer
            doorHeightCm:
              type: number
            maxPayloadKg:
              type: integer
        options:
          type: object
          properties:
            loadingDirection:
              type: string
            optimizeTimeMs:
              type: integer
    PostApiV1PackRequest:
      type: object
      properties:
        cargos:
          type: array
          description: Array of cargo items with id, name, shape, dimensions, quantity, weight, color, and packing options
        container:
          type: object
          description: Container specification with id, name, inner dimensions, door dimensions, and max payload
        options:
          type: object
          description: Packing options including loadingDirection and optimizeTimeMs
      required:
      - cargos
      - container
    PostApiV1PackResponse:
      type: object
      properties:
        ok:
          type: boolean
          description: Success indicator
        result.containers:
          type: array
          description: Placements per container
        result.unplaced:
          type: array
          description: Any unplaced pieces
        error:
          type: string
          description: Error string when ok is false
    PostApiV1ReportRequest:
      type: object
      properties:
        cargos:
          type: array
          items: {}
        container:
          type: object
        format:
          type: string
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Api