{
  "openapi": "3.1.0",
  "info": {
    "title": "Muuttokettu Agentic Store API",
    "version": "1.0.0",
    "description": "Agentic Commerce API for Muuttokettu Storefront (RFC Discovery, x402, MPP, UCP & ACP)"
  },
  "x-service-info": {
    "service_name": "Muuttokettu Kauppa",
    "categories": [
      "ecommerce",
      "home",
      "moving",
      "furniture",
      "lifestyle",
      "tyres",
      "appliances"
    ],
    "supported_transports": [
      "https",
      "mcp"
    ]
  },
  "servers": [
    {
      "url": "https://muuttokettu.fi/api"
    }
  ],
  "paths": {
    "/kauppa/search": {
      "get": {
        "summary": "Search Curated & Deep Department Store Inventory",
        "operationId": "searchStore",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "category",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "default": 24
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful product search"
          }
        }
      }
    },
    "/kauppa/order": {
      "post": {
        "summary": "Agentic Order Creation & Checkout Session",
        "operationId": "createAgentOrder",
        "x-payment-info": {
          "intent": "charge",
          "method": "stripe",
          "currency": "EUR",
          "amount": 100,
          "description": "Muuttoketun autonominen ostoskoritilaus"
        },
        "responses": {
          "200": {
            "description": "Order session initiated"
          },
          "402": {
            "description": "Payment required via MPP / x402"
          }
        }
      }
    },
    "/kauppa/agent-pay": {
      "get": {
        "summary": "x402 Agent-Native Payment Gateway",
        "operationId": "x402PaymentGateway",
        "x-payment-info": {
          "intent": "charge",
          "method": "x402",
          "currency": "USDC",
          "network": "base",
          "amount": 0.5,
          "description": "Agentic micro-payment for data and basket dispatch"
        },
        "responses": {
          "200": {
            "description": "Payment confirmed, data dispatched"
          },
          "402": {
            "description": "Payment Required with x402 challenge"
          }
        }
      }
    }
  }
}