{"openapi": "3.0.3", "info": {"title": "KR Export Pulse", "version": "0.1.0", "description": "Korea Customs Service export statistics as change analysis with revision tracking. Observed values only."}, "servers": [{"url": "https://export.pokt-agent.com"}], "paths": {"/v1/version": {"get": {"summary": "Identity", "responses": {"200": {"description": "service id, version, key_configured"}}}}, "/v1/health": {"get": {"summary": "Readiness", "responses": {"200": {"description": "{status: ok}"}}}}, "/v1/items": {"get": {"summary": "The 10 major items and unit", "responses": {"200": {"description": "kr-export-items/v1"}}}}, "/v1/tenday": {"get": {"summary": "10-day cumulative rows + same-fetch increments", "parameters": [{"in": "query", "schema": {"type": "string", "pattern": "^\\d{6}$"}, "description": "YYYYMM", "name": "from"}, {"in": "query", "schema": {"type": "string", "pattern": "^\\d{6}$"}, "description": "YYYYMM", "name": "to"}], "responses": {"200": {"description": "kr-export-tenday/v1"}, "503": {"description": "KEY_NOT_CONFIGURED"}}}}, "/v1/pulse": {"get": {"summary": "Latest period vs prior month / prior year (same stage), item contributions", "parameters": [{"name": "months", "in": "query", "schema": {"type": "integer", "default": 3}}], "responses": {"200": {"description": "kr-export-pulse/v1"}}}}, "/v1/hs": {"get": {"summary": "Monthly trade by HS code and country", "parameters": [{"name": "hs", "in": "query", "required": true, "schema": {"type": "string"}}, {"in": "query", "schema": {"type": "string", "pattern": "^\\d{6}$"}, "description": "YYYYMM", "name": "from"}, {"in": "query", "schema": {"type": "string", "pattern": "^\\d{6}$"}, "description": "YYYYMM", "name": "to"}, {"name": "country", "in": "query", "schema": {"type": "string"}, "description": "ISO-2, e.g. US"}], "responses": {"200": {"description": "kr-export-hs/v1"}}}}, "/v1/revisions": {"get": {"summary": "Revisions of the same period observed across fetches", "parameters": [{"name": "period", "in": "query", "schema": {"type": "string"}}], "responses": {"200": {"description": "kr-export-revisions/v1"}}}}, "/v1/query": {"post": {"summary": "Deterministic question (ko/en)", "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"question": {"type": "string"}, "hs": {"type": "string"}, "from": {"type": "string"}, "to": {"type": "string"}, "country": {"type": "string"}, "months": {"type": "integer"}}}}}}, "responses": {"200": {"description": "kr-export-answer/v1"}}}}}}