{"openapi":"3.1.0","info":{"title":"Nordic Commerce Analyst API","version":"0.2.0","description":"Decision-support API for Norwegian ecommerce product screening. The public pilot includes a free browser-based screening; the paid route uses x402 when enabled."},"servers":[{"url":"https://api.bakebakebake.no"}],"paths":{"/commerce/v1/health":{"get":{"operationId":"getCommerceHealth","summary":"Read service status","responses":{"200":{"description":"Service status"}}}},"/commerce/v1/info":{"get":{"operationId":"getCommerceInfo","summary":"Read capabilities and endpoints","responses":{"200":{"description":"Service information"}}}},"/commerce/v1/demo/product-check":{"post":{"operationId":"demoNorwayProductCheck","summary":"Run the free deterministic Norway product-screening demo","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"productName":{"type":"string","minLength":2,"maxLength":160},"productUrl":{"type":"string","format":"uri","maxLength":500},"description":{"type":"string","maxLength":2000},"category":{"type":"string","enum":["general","cosmetics","food","food_supplement","electronics","toy","textile","medical_device","battery"]},"originCountry":{"type":"string","pattern":"^[A-Z]{2}$"},"destinationCountry":{"type":"string","const":"NO"},"soldDirectToConsumer":{"type":"boolean"},"fulfilmentModel":{"type":"string","enum":["bulk_import_to_norway","cross_border_direct_to_consumer","domestic_supply"]},"weightKg":{"type":"number","exclusiveMinimum":0,"maximum":1000},"dimensionsCm":{"type":"object","additionalProperties":false,"properties":{"length":{"type":"number","exclusiveMinimum":0,"maximum":1000},"width":{"type":"number","exclusiveMinimum":0,"maximum":1000},"height":{"type":"number","exclusiveMinimum":0,"maximum":1000}},"required":["length","width","height"]},"hsCode":{"type":"string","pattern":"^[0-9]{4,10}$"},"containsLiquid":{"type":"boolean"},"batteryIncluded":{"type":"boolean"},"ageRestricted":{"type":"boolean"},"requiresColdChain":{"type":"boolean"},"economics":{"type":"object","additionalProperties":false,"properties":{"purchaseCost":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0,"maximum":1000000000},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"fxToNok":{"type":"number","exclusiveMinimum":0,"maximum":100000}},"required":["amount","currency"]},"sellingPrice":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0,"maximum":1000000000},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"fxToNok":{"type":"number","exclusiveMinimum":0,"maximum":100000}},"required":["amount","currency"]},"inboundShipping":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0,"maximum":1000000000},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"fxToNok":{"type":"number","exclusiveMinimum":0,"maximum":100000}},"required":["amount","currency"]},"dutyRatePct":{"type":"number","minimum":0,"maximum":100},"importVatRatePct":{"type":"number","minimum":0,"maximum":100},"sellingVatRatePct":{"type":"number","minimum":0,"maximum":100},"importVatRecoverable":{"type":"boolean"},"sellingPriceIncludesVat":{"type":"boolean"}},"required":["purchaseCost","sellingPrice"]}},"required":["productName","category","originCountry","destinationCountry","soldDirectToConsumer","fulfilmentModel","weightKg","economics"]},"example":{"productName":"Rechargeable facial cleansing brush","productUrl":"https://example.com/products/facial-brush","category":"electronics","originCountry":"CN","destinationCountry":"NO","soldDirectToConsumer":true,"fulfilmentModel":"bulk_import_to_norway","weightKg":0.45,"dimensionsCm":{"length":22,"width":14,"height":8},"hsCode":"850980","containsLiquid":false,"batteryIncluded":true,"ageRestricted":false,"requiresColdChain":false,"economics":{"purchaseCost":{"amount":12,"currency":"USD","fxToNok":10.5},"sellingPrice":{"amount":699,"currency":"NOK","fxToNok":1},"inboundShipping":{"amount":85,"currency":"NOK","fxToNok":1},"dutyRatePct":0,"importVatRatePct":25,"importVatRecoverable":true,"sellingPriceIncludesVat":true}}}}},"responses":{"200":{"description":"Structured Norway product-screening report","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"reportId":{"type":"string"},"analysisVersion":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"},"decision":{"type":"string","enum":["proceed_with_checks","manual_review","not_recommended"]},"score":{"type":"integer","minimum":0,"maximum":100},"confidence":{"type":"string","enum":["low","medium","high"]},"summary":{"type":"string"},"economics":{"type":"object"},"importAssessment":{"type":"object"},"regulatoryAssessment":{"type":"object"},"marketAssessment":{"type":"object"},"risks":{"type":"array","items":{"type":"object"}},"requiredActions":{"type":"array","items":{"type":"string"}},"limitations":{"type":"array","items":{"type":"string"}}},"required":["success","reportId","analysisVersion","generatedAt","decision","score","confidence","summary","economics","importAssessment","regulatoryAssessment","marketAssessment","risks","requiredActions","limitations"]}}}},"422":{"description":"Input validation failed"},"429":{"description":"Rate limit exceeded"}}}},"/commerce/v1/product-check":{"post":{"operationId":"buyNorwayProductCheck","summary":"Buy a Norway product screening for $49.00","description":"Payment route disabled during MVP review.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"productName":{"type":"string","minLength":2,"maxLength":160},"productUrl":{"type":"string","format":"uri","maxLength":500},"description":{"type":"string","maxLength":2000},"category":{"type":"string","enum":["general","cosmetics","food","food_supplement","electronics","toy","textile","medical_device","battery"]},"originCountry":{"type":"string","pattern":"^[A-Z]{2}$"},"destinationCountry":{"type":"string","const":"NO"},"soldDirectToConsumer":{"type":"boolean"},"fulfilmentModel":{"type":"string","enum":["bulk_import_to_norway","cross_border_direct_to_consumer","domestic_supply"]},"weightKg":{"type":"number","exclusiveMinimum":0,"maximum":1000},"dimensionsCm":{"type":"object","additionalProperties":false,"properties":{"length":{"type":"number","exclusiveMinimum":0,"maximum":1000},"width":{"type":"number","exclusiveMinimum":0,"maximum":1000},"height":{"type":"number","exclusiveMinimum":0,"maximum":1000}},"required":["length","width","height"]},"hsCode":{"type":"string","pattern":"^[0-9]{4,10}$"},"containsLiquid":{"type":"boolean"},"batteryIncluded":{"type":"boolean"},"ageRestricted":{"type":"boolean"},"requiresColdChain":{"type":"boolean"},"economics":{"type":"object","additionalProperties":false,"properties":{"purchaseCost":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0,"maximum":1000000000},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"fxToNok":{"type":"number","exclusiveMinimum":0,"maximum":100000}},"required":["amount","currency"]},"sellingPrice":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0,"maximum":1000000000},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"fxToNok":{"type":"number","exclusiveMinimum":0,"maximum":100000}},"required":["amount","currency"]},"inboundShipping":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","minimum":0,"maximum":1000000000},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"fxToNok":{"type":"number","exclusiveMinimum":0,"maximum":100000}},"required":["amount","currency"]},"dutyRatePct":{"type":"number","minimum":0,"maximum":100},"importVatRatePct":{"type":"number","minimum":0,"maximum":100},"sellingVatRatePct":{"type":"number","minimum":0,"maximum":100},"importVatRecoverable":{"type":"boolean"},"sellingPriceIncludesVat":{"type":"boolean"}},"required":["purchaseCost","sellingPrice"]}},"required":["productName","category","originCountry","destinationCountry","soldDirectToConsumer","fulfilmentModel","weightKg","economics"]},"example":{"productName":"Rechargeable facial cleansing brush","productUrl":"https://example.com/products/facial-brush","category":"electronics","originCountry":"CN","destinationCountry":"NO","soldDirectToConsumer":true,"fulfilmentModel":"bulk_import_to_norway","weightKg":0.45,"dimensionsCm":{"length":22,"width":14,"height":8},"hsCode":"850980","containsLiquid":false,"batteryIncluded":true,"ageRestricted":false,"requiresColdChain":false,"economics":{"purchaseCost":{"amount":12,"currency":"USD","fxToNok":10.5},"sellingPrice":{"amount":699,"currency":"NOK","fxToNok":1},"inboundShipping":{"amount":85,"currency":"NOK","fxToNok":1},"dutyRatePct":0,"importVatRatePct":25,"importVatRecoverable":true,"sellingPriceIncludesVat":true}}}}},"responses":{"200":{"description":"Structured Norway product-screening report","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"reportId":{"type":"string"},"analysisVersion":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"},"decision":{"type":"string","enum":["proceed_with_checks","manual_review","not_recommended"]},"score":{"type":"integer","minimum":0,"maximum":100},"confidence":{"type":"string","enum":["low","medium","high"]},"summary":{"type":"string"},"economics":{"type":"object"},"importAssessment":{"type":"object"},"regulatoryAssessment":{"type":"object"},"marketAssessment":{"type":"object"},"risks":{"type":"array","items":{"type":"object"}},"requiredActions":{"type":"array","items":{"type":"string"}},"limitations":{"type":"array","items":{"type":"string"}}},"required":["success","reportId","analysisVersion","generatedAt","decision","score","confidence","summary","economics","importAssessment","regulatoryAssessment","marketAssessment","risks","requiredActions","limitations"]}}}},"402":{"description":"x402 payment required"},"422":{"description":"Input validation failed"},"503":{"description":"Paid MVP route is not enabled"}}}},"/commerce/v1/SKILL.md":{"get":{"operationId":"getCommerceSkill","summary":"Read agent instructions","responses":{"200":{"description":"Markdown instructions"}}}}}}