{
    "api": {
        "name": "Veruno Agentic Commerce API",
        "version": "2.6",
        "base_url": "https://veruno.cz/api/v1"
    },
    "features": [
        "product_catalog",
        "multi_tenant",
        "configurable_products",
        "stock_management",
        "ai_signals",
        "provenance_tracking",
        "material_hierarchy",
        "document_certificates",
        "author_profiles",
        "coin_verification",
        "knowledge_base",
        "checkout",
        "orders_management",
        "payment_card",
        "payment_bank_transfer",
        "payment_cod",
        "shipping_quote",
        "shipment_tracking",
        "rental_catalog",
        "rental_booking"
    ],
    "authentication": {
        "required": false,
        "note": "Most endpoints are public. Orders write operations and shipping/attach require Bearer token."
    },
    "tenants": [
        {
            "code": "aurent",
            "name": "Aurent",
            "status": "active",
            "_links": {
                "profile": "https://veruno.cz/api/v1/aurent/profile",
                "rental_catalog": "https://veruno.cz/api/v1/aurent/rental/catalog?from={YYYY-MM-DD}&to={YYYY-MM-DD}",
                "rental_quote": "https://veruno.cz/api/v1/aurent/rental/quote",
                "rental_book": "https://veruno.cz/api/v1/aurent/rental/book-public",
                "legal": "https://veruno.cz/api/v1/aurent/legal",
                "terms": "https://veruno.cz/terms/aurent/",
                "privacy": "https://veruno.cz/privacy/aurent/",
                "returns": "https://veruno.cz/returns/aurent/"
            }
        },
        {
            "code": "authra",
            "name": "Authra",
            "status": "active",
            "_links": {
                "profile": "https://veruno.cz/api/v1/authra/profile",
                "rental_catalog": "https://veruno.cz/api/v1/authra/rental/catalog?from={YYYY-MM-DD}&to={YYYY-MM-DD}",
                "rental_quote": "https://veruno.cz/api/v1/authra/rental/quote",
                "rental_book": "https://veruno.cz/api/v1/authra/rental/book-public",
                "legal": "https://veruno.cz/api/v1/authra/legal",
                "terms": "https://veruno.cz/terms/authra/",
                "privacy": "https://veruno.cz/privacy/authra/",
                "returns": "https://veruno.cz/returns/authra/"
            }
        },
        {
            "code": "eventaudio",
            "name": "Eventaudio",
            "status": "active",
            "_links": {
                "profile": "https://veruno.cz/api/v1/eventaudio/profile",
                "rental_catalog": "https://veruno.cz/api/v1/eventaudio/rental/catalog?from={YYYY-MM-DD}&to={YYYY-MM-DD}",
                "rental_quote": "https://veruno.cz/api/v1/eventaudio/rental/quote",
                "rental_book": "https://veruno.cz/api/v1/eventaudio/rental/book-public",
                "legal": "https://veruno.cz/api/v1/eventaudio/legal",
                "terms": "https://veruno.cz/terms/eventaudio/",
                "privacy": "https://veruno.cz/privacy/eventaudio/",
                "returns": "https://veruno.cz/returns/eventaudio/"
            }
        },
        {
            "code": "inmart",
            "name": "inMart.cz",
            "status": "active",
            "_links": {
                "profile": "https://veruno.cz/api/v1/inmart/profile",
                "pricelist": "https://veruno.cz/api/v1/inmart/pricelist",
                "stock_products": "https://veruno.cz/api/v1/inmart/stock",
                "stock_attributes": "https://veruno.cz/api/v1/inmart/stock/attributes",
                "stock_settings": "https://veruno.cz/api/v1/inmart/stock/settings",
                "stock_storefront": "https://veruno.cz/api/v1/inmart/stock/store",
                "orders": "https://veruno.cz/api/v1/inmart/orders",
                "orders_carriers": "https://veruno.cz/api/v1/inmart/orders/carriers",
                "tracking": "https://veruno.cz/api/v1/tracking/{order_number}?postcode=X",
                "checkout_sessions": "https://veruno.cz/api/v1/inmart/checkout/sessions",
                "storefront_public_url": "https://veruno.cz/store/inmart/",
                "storefront_products_api": "https://veruno.cz/api/v1/inmart/stock/store",
                "shipping_quote": "https://veruno.cz/api/v1/inmart/shipping/quote",
                "shipping_methods": "https://veruno.cz/api/v1/inmart/shipping/methods",
                "shipping_zones": "https://veruno.cz/api/v1/inmart/shipping/zones",
                "payment_methods": "https://veruno.cz/api/v1/inmart/payment-methods",
                "knowledge": "https://veruno.cz/api/v1/inmart/knowledge",
                "knowledge_faq": "https://veruno.cz/api/v1/inmart/knowledge?type=faq",
                "knowledge_search": "https://veruno.cz/api/v1/inmart/knowledge/search?q={query}",
                "agent": "https://veruno.cz/api/v1/inmart/agent/widget",
                "agent_conversations": "https://veruno.cz/api/v1/inmart/agent/conversations",
                "legal": "https://veruno.cz/api/v1/inmart/legal",
                "terms": "https://veruno.cz/terms/inmart/",
                "privacy": "https://veruno.cz/privacy/inmart/",
                "returns": "https://veruno.cz/returns/inmart/",
                "feed_heureka": "https://veruno.cz/feed/inmart/heureka.xml",
                "feed_google": "https://veruno.cz/feed/inmart/google.xml",
                "feed_zbozi": "https://veruno.cz/feed/inmart/zbozi.xml",
                "feed_facebook": "https://veruno.cz/feed/inmart/facebook.xml"
            }
        },
        {
            "code": "macooin",
            "name": "Macooin",
            "status": "active",
            "_links": {
                "profile": "https://veruno.cz/api/v1/macooin/profile",
                "products": "https://veruno.cz/api/v1/macooin/products",
                "sources": "https://veruno.cz/api/v1/macooin/sources",
                "categories": "https://veruno.cz/api/v1/macooin/categories",
                "authors": "https://veruno.cz/api/v1/macooin/authors",
                "documents": "https://veruno.cz/api/v1/macooin/documents",
                "pricelist": "https://veruno.cz/api/v1/macooin/pricelist",
                "stock_products": "https://veruno.cz/api/v1/macooin/stock",
                "stock_attributes": "https://veruno.cz/api/v1/macooin/stock/attributes",
                "stock_settings": "https://veruno.cz/api/v1/macooin/stock/settings",
                "stock_storefront": "https://veruno.cz/api/v1/macooin/stock/store",
                "legal": "https://veruno.cz/api/v1/macooin/legal",
                "terms": "https://veruno.cz/terms/macooin/",
                "privacy": "https://veruno.cz/privacy/macooin/",
                "returns": "https://veruno.cz/returns/macooin/"
            }
        },
        {
            "code": "magnet",
            "name": "Magnet",
            "status": "active",
            "_links": {
                "profile": "https://veruno.cz/api/v1/magnet/profile",
                "pricelist": "https://veruno.cz/api/v1/magnet/pricelist",
                "stock_products": "https://veruno.cz/api/v1/magnet/stock",
                "stock_attributes": "https://veruno.cz/api/v1/magnet/stock/attributes",
                "stock_settings": "https://veruno.cz/api/v1/magnet/stock/settings",
                "stock_storefront": "https://veruno.cz/api/v1/magnet/stock/store",
                "orders": "https://veruno.cz/api/v1/magnet/orders",
                "orders_carriers": "https://veruno.cz/api/v1/magnet/orders/carriers",
                "tracking": "https://veruno.cz/api/v1/tracking/{order_number}?postcode=X",
                "checkout_sessions": "https://veruno.cz/api/v1/magnet/checkout/sessions",
                "storefront_public_url": "https://veruno.cz/store/magnet/",
                "storefront_products_api": "https://veruno.cz/api/v1/magnet/stock/store",
                "shipping_quote": "https://veruno.cz/api/v1/magnet/shipping/quote",
                "shipping_methods": "https://veruno.cz/api/v1/magnet/shipping/methods",
                "shipping_zones": "https://veruno.cz/api/v1/magnet/shipping/zones",
                "payment_methods": "https://veruno.cz/api/v1/magnet/payment-methods",
                "knowledge": "https://veruno.cz/api/v1/magnet/knowledge",
                "knowledge_faq": "https://veruno.cz/api/v1/magnet/knowledge?type=faq",
                "knowledge_search": "https://veruno.cz/api/v1/magnet/knowledge/search?q={query}",
                "legal": "https://veruno.cz/api/v1/magnet/legal",
                "terms": "https://veruno.cz/terms/magnet/",
                "privacy": "https://veruno.cz/privacy/magnet/",
                "returns": "https://veruno.cz/returns/magnet/",
                "feed_heureka": "https://veruno.cz/feed/magnet/heureka.xml",
                "feed_google": "https://veruno.cz/feed/magnet/google.xml",
                "feed_zbozi": "https://veruno.cz/feed/magnet/zbozi.xml",
                "feed_facebook": "https://veruno.cz/feed/magnet/facebook.xml"
            }
        },
        {
            "code": "nejlevnejsipytel",
            "name": "NejlevnějšíPytel.cz",
            "status": "active",
            "_links": {
                "profile": "https://veruno.cz/api/v1/nejlevnejsipytel/profile",
                "pricelist": "https://veruno.cz/api/v1/nejlevnejsipytel/pricelist",
                "stock_products": "https://veruno.cz/api/v1/nejlevnejsipytel/stock",
                "stock_attributes": "https://veruno.cz/api/v1/nejlevnejsipytel/stock/attributes",
                "stock_settings": "https://veruno.cz/api/v1/nejlevnejsipytel/stock/settings",
                "stock_storefront": "https://veruno.cz/api/v1/nejlevnejsipytel/stock/store",
                "orders": "https://veruno.cz/api/v1/nejlevnejsipytel/orders",
                "orders_carriers": "https://veruno.cz/api/v1/nejlevnejsipytel/orders/carriers",
                "tracking": "https://veruno.cz/api/v1/tracking/{order_number}?postcode=X",
                "checkout_sessions": "https://veruno.cz/api/v1/nejlevnejsipytel/checkout/sessions",
                "storefront_public_url": "https://veruno.cz/store/nejlevnejsipytel/",
                "storefront_products_api": "https://veruno.cz/api/v1/nejlevnejsipytel/stock/store",
                "payment_methods": "https://veruno.cz/api/v1/nejlevnejsipytel/payment-methods",
                "knowledge": "https://veruno.cz/api/v1/nejlevnejsipytel/knowledge",
                "knowledge_faq": "https://veruno.cz/api/v1/nejlevnejsipytel/knowledge?type=faq",
                "knowledge_search": "https://veruno.cz/api/v1/nejlevnejsipytel/knowledge/search?q={query}",
                "legal": "https://veruno.cz/api/v1/nejlevnejsipytel/legal",
                "terms": "https://veruno.cz/terms/nejlevnejsipytel/",
                "privacy": "https://veruno.cz/privacy/nejlevnejsipytel/",
                "returns": "https://veruno.cz/returns/nejlevnejsipytel/",
                "feed_heureka": "https://veruno.cz/feed/nejlevnejsipytel/heureka.xml",
                "feed_google": "https://veruno.cz/feed/nejlevnejsipytel/google.xml",
                "feed_zbozi": "https://veruno.cz/feed/nejlevnejsipytel/zbozi.xml",
                "feed_facebook": "https://veruno.cz/feed/nejlevnejsipytel/facebook.xml"
            }
        },
        {
            "code": "plantero",
            "name": "Plantero.cz",
            "status": "active",
            "_links": {
                "profile": "https://veruno.cz/api/v1/plantero/profile",
                "orders": "https://veruno.cz/api/v1/plantero/orders",
                "orders_carriers": "https://veruno.cz/api/v1/plantero/orders/carriers",
                "tracking": "https://veruno.cz/api/v1/tracking/{order_number}?postcode=X",
                "checkout_sessions": "https://veruno.cz/api/v1/plantero/checkout/sessions",
                "storefront_public_url": "https://veruno.cz/store/plantero/",
                "storefront_products_api": "https://veruno.cz/api/v1/plantero/stock/store",
                "shipping_quote": "https://veruno.cz/api/v1/plantero/shipping/quote",
                "shipping_methods": "https://veruno.cz/api/v1/plantero/shipping/methods",
                "shipping_zones": "https://veruno.cz/api/v1/plantero/shipping/zones",
                "payment_methods": "https://veruno.cz/api/v1/plantero/payment-methods",
                "knowledge": "https://veruno.cz/api/v1/plantero/knowledge",
                "knowledge_faq": "https://veruno.cz/api/v1/plantero/knowledge?type=faq",
                "knowledge_search": "https://veruno.cz/api/v1/plantero/knowledge/search?q={query}",
                "legal": "https://veruno.cz/api/v1/plantero/legal",
                "terms": "https://veruno.cz/terms/plantero/",
                "privacy": "https://veruno.cz/privacy/plantero/",
                "returns": "https://veruno.cz/returns/plantero/",
                "feed_heureka": "https://veruno.cz/feed/plantero/heureka.xml",
                "feed_google": "https://veruno.cz/feed/plantero/google.xml",
                "feed_zbozi": "https://veruno.cz/feed/plantero/zbozi.xml",
                "feed_facebook": "https://veruno.cz/feed/plantero/facebook.xml"
            }
        }
    ],
    "endpoints": {
        "core": [
            {
                "name": "health",
                "method": "GET",
                "path": "/api/v1/health",
                "auth": false,
                "description": "API health check"
            },
            {
                "name": "capabilities",
                "method": "GET",
                "path": "/api/v1/capabilities",
                "auth": false,
                "description": "API capabilities discovery (this endpoint)"
            },
            {
                "name": "list_tenants",
                "method": "GET",
                "path": "/api/v1/tenants",
                "auth": false,
                "description": "List all public tenants"
            },
            {
                "name": "get_profile",
                "method": "GET",
                "path": "/api/v1/{tenant}/profile",
                "auth": false,
                "description": "Tenant profile with capabilities and available endpoints"
            },
            {
                "name": "get_legal",
                "method": "GET",
                "path": "/api/v1/{tenant}/legal",
                "auth": false,
                "description": "Links to terms, privacy policy and returns policy"
            }
        ],
        "products": [
            {
                "name": "browse_products",
                "method": "GET",
                "path": "/api/v1/{tenant}/products",
                "auth": false,
                "description": "List products with filtering, sorting and pagination"
            },
            {
                "name": "get_product_detail",
                "method": "GET",
                "path": "/api/v1/{tenant}/products/{sku}",
                "auth": false,
                "description": "Product detail with attributes, media and price"
            },
            {
                "name": "browse_categories",
                "method": "GET",
                "path": "/api/v1/{tenant}/categories",
                "auth": false,
                "description": "Product category tree"
            },
            {
                "name": "browse_catalog",
                "method": "GET",
                "path": "/api/v1/{tenant}/stock",
                "auth": false,
                "description": "Full tenant catalog: category tree, dynamic attributes and product permalinks"
            },
            {
                "name": "get_store_products",
                "method": "GET",
                "path": "/api/v1/{tenant}/stock/store",
                "auth": false,
                "description": "Storefront offer only: in stock, with price and permalink"
            },
            {
                "name": "get_catalog_products",
                "method": "GET",
                "path": "/api/v1/{tenant}/stock/catalog?page={page}&limit={limit}",
                "auth": false,
                "description": "Full active catalog: all products paginated (beyond the curated storefront)"
            }
        ],
        "provenance": [
            {
                "name": "get_provenance",
                "method": "GET",
                "path": "/api/v1/{tenant}/products/{sku}?include=provenance",
                "auth": false,
                "description": "Material provenance of a product with hierarchy and timeline"
            },
            {
                "name": "browse_sources",
                "method": "GET",
                "path": "/api/v1/{tenant}/sources",
                "auth": false,
                "description": "Browse material sources"
            },
            {
                "name": "get_documents",
                "method": "GET",
                "path": "/api/v1/{tenant}/documents",
                "auth": false,
                "description": "Product certificates and documents"
            },
            {
                "name": "get_authors",
                "method": "GET",
                "path": "/api/v1/{tenant}/authors",
                "auth": false,
                "description": "Author and maker profiles"
            },
            {
                "name": "verify_authenticity",
                "method": "GET",
                "path": "/api/v1/{tenant}/verify?code={code}&hash={hash}",
                "auth": false,
                "description": "Verify product authenticity by its coin code and hash"
            }
        ],
        "knowledge": [
            {
                "name": "get_knowledge",
                "method": "GET",
                "path": "/api/v1/{tenant}/knowledge",
                "auth": false,
                "description": "Knowledge base articles; ?type=faq returns frequently asked questions"
            },
            {
                "name": "search_knowledge",
                "method": "GET",
                "path": "/api/v1/{tenant}/knowledge/search?q={query}",
                "auth": false,
                "description": "Full-text search in the knowledge base"
            }
        ],
        "shipping": [
            {
                "name": "shipping_quote",
                "method": "POST",
                "path": "/api/v1/{tenant}/shipping/quote",
                "auth": false,
                "description": "Calculate shipping price for country, weight, value and volume"
            },
            {
                "name": "shipping_methods",
                "method": "GET",
                "path": "/api/v1/{tenant}/shipping/methods",
                "auth": false,
                "description": "List available shipping methods with pricing tiers"
            },
            {
                "name": "get_shipping_zones",
                "method": "GET",
                "path": "/api/v1/{tenant}/shipping/zones",
                "auth": false,
                "description": "Shipping zones with method ids for checkout"
            },
            {
                "name": "shipping_attach",
                "method": "POST",
                "path": "/api/v1/{tenant}/shipping/attach",
                "auth": "Bearer",
                "description": "Attach a shipping method to an order"
            },
            {
                "name": "get_payment_methods",
                "method": "GET",
                "path": "/api/v1/{tenant}/payment-methods",
                "auth": false,
                "description": "Payment methods enabled for the tenant"
            }
        ],
        "store": [
            {
                "name": "get_storefront",
                "method": "GET",
                "path": "/store/{tenant}/",
                "auth": false,
                "description": "Public storefront page of the tenant"
            },
            {
                "name": "create_order_public",
                "method": "POST",
                "path": "/store/{tenant}/",
                "auth": false,
                "description": "Create an order without a token; card payment returns payment_url for the human to finish"
            }
        ],
        "orders": [
            {
                "name": "create_checkout_session",
                "method": "POST",
                "path": "/api/v1/{tenant}/checkout/sessions",
                "auth": "Bearer",
                "description": "Create a checkout session with items, shipping and payment method"
            },
            {
                "name": "confirm_checkout",
                "method": "POST",
                "path": "/api/v1/{tenant}/checkout/sessions/{id}/confirm",
                "auth": "Bearer",
                "description": "Confirm a checkout session and create the order"
            },
            {
                "name": "list_orders",
                "method": "GET",
                "path": "/api/v1/{tenant}/orders",
                "auth": "Bearer",
                "description": "List orders"
            },
            {
                "name": "get_order",
                "method": "GET",
                "path": "/api/v1/{tenant}/orders/{number}",
                "auth": "Bearer",
                "description": "Order detail"
            },
            {
                "name": "confirm_payment",
                "method": "POST",
                "path": "/api/v1/{tenant}/orders/{id}/confirm-payment",
                "auth": "Bearer",
                "description": "Confirm payment of an order (manual or webhook)"
            },
            {
                "name": "change_order_status",
                "method": "PUT",
                "path": "/api/v1/{tenant}/orders/{id}/status",
                "auth": "Bearer",
                "description": "Change order status"
            }
        ],
        "tracking": [
            {
                "name": "track_order",
                "method": "GET",
                "path": "/api/v1/tracking/{order}?postcode={zip}",
                "auth": false,
                "description": "Public shipment tracking by order number and postcode; returns no personal data. Add &format=html for a human-readable page (default is JSON)"
            }
        ],
        "rental": [
            {
                "name": "rental_catalog",
                "method": "GET",
                "path": "/api/v1/{tenant}/rental/catalog?loc={loc}&from={from}&to={to}",
                "auth": false,
                "description": "Rental items available in a date range, including how many are free"
            },
            {
                "name": "rental_quote",
                "method": "POST",
                "path": "/api/v1/{tenant}/rental/quote",
                "auth": false,
                "description": "Price and availability of a rental without creating a booking"
            },
            {
                "name": "rental_book_public",
                "method": "POST",
                "path": "/api/v1/{tenant}/rental/book-public",
                "auth": false,
                "description": "Create a rental booking awaiting payment; returns payment_url for the human to finish"
            },
            {
                "name": "rental_booking_status",
                "method": "GET",
                "path": "/api/v1/{tenant}/rental/bookings/{code}?t={access_token}",
                "auth": false,
                "description": "Booking status by code and access token"
            }
        ]
    },
    "pagination": {
        "default_limit": 20,
        "max_limit": 100,
        "style": "offset",
        "links": [
            "self",
            "first",
            "prev",
            "next",
            "last"
        ]
    },
    "filtering": {
        "supported": true,
        "syntax": "filter[field]=value or filter[field][op]=value",
        "operators": [
            "eq",
            "ne",
            "gt",
            "gte",
            "lt",
            "lte",
            "in",
            "like"
        ]
    },
    "sorting": {
        "supported": true,
        "syntax": "sort=field or sort=-field (desc) or sort=field1,-field2"
    },
    "rate_limits": {
        "anonymous": {
            "limit": 100,
            "window_seconds": 60
        },
        "note": "Some public operations have their own stricter limit on top of this one; see endpoints[].limits."
    },
    "_links": {
        "self": "https://veruno.cz/api/v1/capabilities",
        "health": "https://veruno.cz/api/v1/health",
        "tenants": "https://veruno.cz/api/v1/tenants",
        "documentation": "https://veruno.cz/docs"
    }
}