{"openapi": "3.1.0", "info": {"title": "Insilos Enterprise Global Trade & Logistics Commercial Data API", "version": "1.0.0", "description": "High-performance REST API Suite providing metered B2B access to Insilos 3-Tier Lakehouse (Bronze CAS Shards, Silver OLAP Cubes & DuckDB/SQLite, Gold Transactional PostgreSQL). Features tier-aware PII gating, real-time credit deduction, and 100% sovereign local execution.", "contact": {"name": "Insilos Data API Support", "email": "data-api@insilos.com", "url": "https://insilos.com/solutions/trade-intelligence"}}, "servers": [{"url": "/api/v1/data-api", "description": "Production Insilos Trade Data API Cluster"}], "security": [{"ApiKeyAuth": []}, {"BearerAuth": []}], "components": {"securitySchemes": {"ApiKeyAuth": {"type": "apiKey", "in": "header", "name": "X-API-Key", "description": "Subscriber Commercial B2B API Key (prefix: ins_live_*)"}, "BearerAuth": {"type": "http", "scheme": "bearer", "description": "Bearer token authentication using Commercial B2B API Key"}}, "schemas": {"WarehouseTelemetryResponse": {"type": "object", "properties": {"status": {"type": "string", "example": "success"}, "tier1_bronze_cas": {"type": "object"}, "tier2_silver_lakehouse": {"type": "object"}, "tier3_gold_postgresql": {"type": "object"}, "subscription_metering": {"type": "object"}}}, "AnalyticsSummaryResponse": {"type": "object", "properties": {"status": {"type": "string", "example": "success"}, "executive_kpis": {"type": "object"}, "corridor_analytics": {"type": "object"}, "tariff_duty_savings": {"type": "object"}, "port_carrier_performance": {"type": "object"}, "esg_cbam_eudr_compliance": {"type": "object"}, "knowledge_graph_summary": {"type": "object"}}}, "ShipmentsSearchResponse": {"type": "object", "properties": {"status": {"type": "string", "example": "success"}, "total_count": {"type": "integer", "example": 59}, "returned_count": {"type": "integer", "example": 20}, "records": {"type": "array", "items": {"type": "object"}}, "facets": {"type": "object"}}}, "TariffsAndOriginResponse": {"type": "object", "properties": {"status": {"type": "string", "example": "success"}, "query_hs_code": {"type": "string", "example": "090111"}, "query_fta_agreement": {"type": "string", "example": "EVFTA"}, "tariffs": {"type": "array", "items": {"type": "object"}}, "origin_rules": {"type": "array", "items": {"type": "object"}}, "customs_rulings": {"type": "array", "items": {"type": "object"}}, "tariff_savings_analytics": {"type": "object"}}}, "SupplyChainGraphResponse": {"type": "object", "properties": {"status": {"type": "string", "example": "success"}, "graph_metrics": {"type": "object"}, "nodes": {"type": "array", "items": {"type": "object"}}, "edges": {"type": "array", "items": {"type": "object"}}}}, "B2BContactsResponse": {"type": "object", "properties": {"status": {"type": "string", "example": "success"}, "total_count": {"type": "integer", "example": 61}, "returned_count": {"type": "integer", "example": 20}, "pii_access_tier": {"type": "string", "example": "enterprise_279m"}, "pii_masked_enforced": {"type": "boolean", "example": false}, "contacts": {"type": "array", "items": {"type": "object"}}}}, "OilspillExpansionRequest": {"type": "object", "properties": {"ring": {"type": "string", "default": "all", "description": "Ring filter (comma-sep or 'all'). R0_CORE, R1_HS_BOM, R2_PORTS_GRAPH, R3_CBAM_B2B"}, "corridor": {"type": "string", "example": "VNSGN-NLRTM"}, "entity_type": {"type": "string", "description": "Filter by entity type"}, "min_priority": {"type": "number", "format": "float", "default": 0.0}, "limit": {"type": "integer", "default": 25, "maximum": 500}, "offset": {"type": "integer", "default": 0}}}, "OilspillRingRollup": {"type": "object", "properties": {"candidates_count": {"type": "integer"}, "admitted_count": {"type": "integer"}, "saturation_ratio": {"type": "number", "format": "float"}, "avg_confidence": {"type": "number", "format": "float"}, "discovered_trade_value_usd": {"type": "number", "format": "double"}}}, "OilspillGateTelemetry": {"type": "object", "properties": {"total_evaluated": {"type": "integer"}, "admitted_count": {"type": "integer"}, "rejected_gate_a": {"type": "integer"}, "rejected_gate_b": {"type": "integer"}, "rejected_gate_c_dup": {"type": "integer"}, "pass_rate_pct": {"type": "number", "format": "float"}}}, "OilspillFrontierItem": {"type": "object", "properties": {"id": {"type": "integer"}, "entity_urn": {"type": "string", "example": "urn:hs:bom:090111->090121"}, "ring_id": {"type": "string", "enum": ["R0_CORE", "R1_HS_BOM", "R2_PORTS_GRAPH", "R3_CBAM_B2B"]}, "corridor": {"type": "string", "example": "VNSGN-NLRTM"}, "entity_type": {"type": "string"}, "priority_score": {"type": "number", "format": "float"}, "confidence_score": {"type": "number", "format": "float"}, "gate_status": {"type": "string", "enum": ["admitted", "pending", "rejected_gate_a", "rejected_gate_b", "rejected_gate_c"]}, "payload": {"type": "object"}, "created_at": {"type": "string"}}}, "OilspillMethodology": {"type": "object", "properties": {"concentric_rings": {"type": "object"}, "confidence_decay_formula": {"type": "string"}, "saturation_formula": {"type": "string"}, "priority_formula": {"type": "string"}, "reliability_guard": {"type": "object"}}}, "ClaudeSwarmRouting": {"type": "object", "properties": {"exclusive_models": {"type": "array", "items": {"type": "string"}}, "tier": {"type": "string", "example": "pro"}, "active_claude_pro_nodes": {"type": "integer", "example": 10}, "prompt_guard": {"type": "string"}}}, "OilspillExpansionResponse": {"type": "object", "required": ["status", "frontier_items"], "properties": {"status": {"type": "string", "example": "success"}, "oilspill_methodology": {"$ref": "#/components/schemas/OilspillMethodology"}, "claude_swarm_routing": {"$ref": "#/components/schemas/ClaudeSwarmRouting"}, "ring_rollup_summary": {"type": "object"}, "reliability_gate_telemetry": {"$ref": "#/components/schemas/OilspillGateTelemetry"}, "frontier_items": {"type": "array", "items": {"$ref": "#/components/schemas/OilspillFrontierItem"}}, "pagination": {"type": "object"}, "query_time_ms": {"type": "number", "format": "float"}}}, "ExportOlapAndDshhResponse": {"type": "object", "properties": {"status": {"type": "string", "example": "success"}, "dataset": {"type": "string", "example": "corridor_monthly"}, "export_format": {"type": "string", "example": "json"}, "row_count": {"type": "integer", "example": 50}, "export_sha256": {"type": "string", "example": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"}, "cwe1236_sanitized": {"type": "boolean", "example": true}, "payload": {"description": "Array of row dicts for json, CSV text for csv, base64 string for xlsx_base64"}}}, "SubscriptionUsageAndBillingResponse": {"type": "object", "properties": {"status": {"type": "string", "example": "success"}, "subscription_profile": {"type": "object"}, "usage_telemetry_by_endpoint": {"type": "array", "items": {"type": "object"}}, "tier_upgrade_matrix": {"type": "object"}}}}, "x-commercial-subscription-packages": {"business_49m": {"annual_fee_vnd": 49000000, "annual_records_quota": 900000, "monthly_records_quota": 75000, "rate_limit_req_per_min": 120, "key_prefix": "ins_live_biz_", "pii_access": "PARTIALLY_MASKED", "features": ["Telemetry", "Summary Analytics", "Shipment Search", "Tariffs Lookup"]}, "pro_79m": {"annual_fee_vnd": 79000000, "annual_records_quota": 1800000, "monthly_records_quota": 150000, "rate_limit_req_per_min": 300, "key_prefix": "ins_live_pro_", "pii_access": "FULL_UNMASKED", "features": ["All Business Features", "Full Unmasked B2B Contacts", "EUR.1 Origin Matrix", "DCSA Telemetry"]}, "premium_129m": {"annual_fee_vnd": 129000000, "annual_records_quota": 3600000, "monthly_records_quota": 300000, "rate_limit_req_per_min": 600, "key_prefix": "ins_live_prm_", "pii_access": "FULL_UNMASKED", "features": ["All Pro Features", "Supply Chain Knowledge Graph", "CBAM Scope 3 Emissions", "Custom Webhooks"]}, "enterprise_279m": {"annual_fee_vnd": 279000000, "annual_records_quota": 18000000, "monthly_records_quota": 1500000, "rate_limit_req_per_min": 1200, "key_prefix": "ins_live_ent_", "pii_access": "FULL_UNMASKED_PRIORITY", "features": ["All Premium Features", "Dedicated DuckDB Shards", "Real-Time CDC Stream", "SLA 99.9%"]}, "supply_chain_manifest_5a": {"annual_fee_vnd": 189000000, "annual_records_quota": 7200000, "monthly_records_quota": 600000, "rate_limit_req_per_min": 900, "key_prefix": "ins_live_scm_", "pii_access": "FULL_UNMASKED_PRIORITY", "features": ["GLEIF Level-2 Corporate Relationship Graph", "Company-360 Unified Dossier", "Digitraffic Vessel Port-Call Cargo Manifests", "US CBP/BIS & AD/CVD Exporter Rulings"]}}}, "paths": {"/warehouse-telemetry": {"get": {"summary": "3-Tier Lakehouse Telemetry & Quota Status", "description": "Returns counts and metrics across Bronze CAS, Silver OLAP cubes, and Gold PostgreSQL tables. Cost: 0 credits.", "responses": {"200": {"description": "Successful telemetry report", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/WarehouseTelemetryResponse"}}}}, "401": {"description": "Invalid or missing API key"}}}}, "/analytics/summary": {"get": {"summary": "Executive Trade & Logistics Analytics Summary", "description": "Combines corridor HHI, HS duty savings, port dwell time, and ESG carbon stats. Cost: 1 credit.", "responses": {"200": {"description": "Statistical summary report", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/AnalyticsSummaryResponse"}}}}, "401": {"description": "Invalid or missing API key"}, "429": {"description": "Quota credits exhausted"}}}}, "/shipments/search": {"get": {"summary": "Multi-Facet Shipment Bill of Lading Search", "description": "Search bills of lading by keyword, HS code, regime, EUR.1 status, and port. Cost: 1 credit per returned record.", "parameters": [{"name": "q", "in": "query", "schema": {"type": "string"}, "description": "Free text query"}, {"name": "hs_code", "in": "query", "schema": {"type": "string"}, "description": "HS code prefix"}, {"name": "customs_regime", "in": "query", "schema": {"type": "string"}, "description": "E31, E11, A12, B11, G13"}, {"name": "eur1_status", "in": "query", "schema": {"type": "string"}, "description": "qualified_wo, qualified_psr, pending"}, {"name": "port_code", "in": "query", "schema": {"type": "string"}, "description": "UN/LOCODE e.g. VNSGN"}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 20}}, {"name": "offset", "in": "query", "schema": {"type": "integer", "default": 0}}], "responses": {"200": {"description": "Matching shipments and facets", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ShipmentsSearchResponse"}}}}, "401": {"description": "Invalid or missing API key"}, "429": {"description": "Quota credits exhausted"}}}}, "/tariffs-and-origin": {"get": {"summary": "Tariff Schedules & Preferential Origin Rules", "description": "Lookup MFN tariffs, EVFTA/CPTPP preferential origin rules, and customs advance rulings. Cost: 1 credit.", "parameters": [{"name": "hs_code", "in": "query", "schema": {"type": "string", "default": "090111"}, "description": "HS code prefix"}, {"name": "fta_code", "in": "query", "schema": {"type": "string", "default": "EVFTA"}, "description": "Target FTA agreement"}], "responses": {"200": {"description": "Tariff schedules and origin determination", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/TariffsAndOriginResponse"}}}}, "401": {"description": "Invalid or missing API key"}, "429": {"description": "Quota credits exhausted"}}}}, "/supply-chain-graph": {"get": {"summary": "Supply Chain Topology & Knowledge Graph", "description": "Trace vendor-buyer relationships, carrier dependencies, and trading network centrality. Cost: 2 credits.", "parameters": [{"name": "node_type", "in": "query", "schema": {"type": "string"}, "description": "Node model type filter"}, {"name": "edge_type", "in": "query", "schema": {"type": "string"}, "description": "Relation type filter"}, {"name": "entity_name", "in": "query", "schema": {"type": "string"}, "description": "Entity name or URN filter"}], "responses": {"200": {"description": "Graph topology and metrics", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/SupplyChainGraphResponse"}}}}, "401": {"description": "Invalid or missing API key"}, "429": {"description": "Quota credits exhausted"}}}}, "/b2b-contacts": {"get": {"summary": "Verified B2B Trade Contacts Book", "description": "Search verified procurement and logistics decision-makers. Enforces tier-aware PII gating. Cost: 2 credits per returned contact.", "parameters": [{"name": "company_name", "in": "query", "schema": {"type": "string"}, "description": "Company name filter"}, {"name": "department", "in": "query", "schema": {"type": "string"}, "description": "procurement, logistics, executive, trade_sales, compliance"}, {"name": "country_code", "in": "query", "schema": {"type": "string"}, "description": "ISO-2 country code"}, {"name": "min_confidence", "in": "query", "schema": {"type": "number", "default": 80.0}}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 20}}, {"name": "offset", "in": "query", "schema": {"type": "integer", "default": 0}}], "responses": {"200": {"description": "Verified B2B trade contacts", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/B2BContactsResponse"}}}}, "401": {"description": "Invalid or missing API key"}, "429": {"description": "Quota credits exhausted"}}}}, "/oilspill-expansion": {"get": {"summary": "4-Ring Concentric Oil-Spill Lakehouse Expansion Query", "description": "Returns concentric-ring entity discovery results, priority queue, ring rollups, and 3-gate reliability telemetry. Cost: 1 credit.", "parameters": [{"name": "ring", "in": "query", "schema": {"type": "string", "default": "all"}, "description": "Ring filter (R0_CORE, R1_HS_BOM, R2_PORTS_GRAPH, R3_CBAM_B2B, or all)"}, {"name": "corridor", "in": "query", "schema": {"type": "string"}, "description": "Trade corridor code (e.g. VNSGN-NLRTM)"}, {"name": "entity_type", "in": "query", "schema": {"type": "string"}, "description": "Entity classification filter"}, {"name": "min_priority", "in": "query", "schema": {"type": "number", "default": 0.0}, "description": "Minimum priority score threshold"}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 25}, "description": "Max records to return"}, {"name": "offset", "in": "query", "schema": {"type": "integer", "default": 0}, "description": "Pagination offset"}], "responses": {"200": {"description": "Successful oil-spill frontier response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/OilspillExpansionResponse"}}}}, "401": {"description": "Invalid or missing API key"}, "429": {"description": "Quota credits exhausted"}}}, "post": {"summary": "4-Ring Concentric Oil-Spill Lakehouse Expansion Query (POST Body)", "description": "Accepts parameters as JSON body. Cost: 1 credit.", "requestBody": {"required": false, "content": {"application/json": {"schema": {"$ref": "#/components/schemas/OilspillExpansionRequest"}}}}, "responses": {"200": {"description": "Successful oil-spill frontier response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/OilspillExpansionResponse"}}}}, "401": {"description": "Invalid or missing API key"}, "429": {"description": "Quota credits exhausted"}}}}, "/export/olap-and-dshh": {"get": {"summary": "Multi-Format Export of OLAP Silver Cubes & DSHH Shipments", "description": "Export corridor analytics, tariff analytics, port performance, oil-spill frontier, or shipment records in JSON, CSV, or XLSX (base64) format with CWE-1236 sanitization and SHA-256 integrity verification. Cost: 5 credits.", "parameters": [{"name": "dataset", "in": "query", "schema": {"type": "string", "enum": ["corridor_monthly", "hs_tariff_analytics", "port_carrier_performance", "oilspill_frontier", "shipments_dshh"], "default": "corridor_monthly"}}, {"name": "export_format", "in": "query", "schema": {"type": "string", "enum": ["json", "csv", "xlsx_base64"], "default": "json"}}, {"name": "corridor", "in": "query", "schema": {"type": "string"}, "description": "Trade corridor code (e.g. VNSGN-NLRTM)"}, {"name": "hs_chapter", "in": "query", "schema": {"type": "string"}, "description": "2-digit HS Chapter (e.g. 09)"}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 50, "maximum": 500}}], "responses": {"200": {"description": "Successful export response", "headers": {"X-Export-SHA256": {"schema": {"type": "string"}, "description": "SHA-256 integrity hash of exported payload bytes"}}, "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ExportOlapAndDshhResponse"}}}}, "401": {"description": "Invalid or missing API key"}, "429": {"description": "Quota credits exhausted"}}}, "post": {"summary": "Multi-Format Export of OLAP Silver Cubes & DSHH Shipments (POST Body)", "description": "Accepts export parameters as JSON body. Cost: 5 credits.", "responses": {"200": {"description": "Successful export response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ExportOlapAndDshhResponse"}}}}, "401": {"description": "Invalid or missing API key"}, "429": {"description": "Quota credits exhausted"}}}}, "/subscription/usage-and-billing": {"get": {"summary": "Caller Subscription Profile & Real-Time Usage Telemetry", "description": "Returns subscriber package tier, remaining quota, utilization percentage, aggregated call metrics by endpoint, and tier upgrade comparison matrix. Cost: 0 credits.", "responses": {"200": {"description": "Successful subscription usage report", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/SubscriptionUsageAndBillingResponse"}}}}, "401": {"description": "Invalid or missing API key"}}}, "post": {"summary": "Caller Subscription Profile & Real-Time Usage Telemetry (POST)", "description": "Returns subscriber package tier and telemetry. Cost: 0 credits.", "responses": {"200": {"description": "Successful subscription usage report", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/SubscriptionUsageAndBillingResponse"}}}}, "401": {"description": "Invalid or missing API key"}}}}, "/openapi.json": {"get": {"summary": "OpenAPI 3.1.0 Specification", "description": "Returns machine-readable OpenAPI documentation for all data endpoints. Cost: 0 credits (public).", "responses": {"200": {"description": "OpenAPI 3.1.0 JSON document"}}}}, "/api/v1/data-api/register-developer": {"x-relative-path": "/register-developer", "post": {"summary": "Self-Service Developer Portal Account Registration & RFC-5322 OTP Delivery", "description": "Registers a developer account, generates a 6-digit OTP, delivers a standards-compliant RFC-5322 .eml to the developer mailbox spool and Odoo mail.mail, and returns registration_uid.", "responses": {"200": {"description": "OTP generated and delivered via RFC-5322 .eml and Odoo mail.mail"}, "400": {"description": "Missing or invalid email parameter"}}}}, "/api/v1/data-api/verify-otp": {"x-relative-path": "/verify-otp", "post": {"summary": "Verify 6-Digit OTP & Mint Live Commercial API Key (ins_live_*)", "description": "Validates the SHA-256 OTP code against is_trade_developer_registration, mints a live API key (ins_live_*), and provisions an active 50,000-credit ledger in is.trade.quota.ledger.", "responses": {"200": {"description": "OTP verified and live API key minted"}, "400": {"description": "Invalid OTP or registration UID"}}}}, "/api/v1/data-api/live-provenance-audit": {"x-relative-path": "/live-provenance-audit", "get": {"summary": "Zero-Fake-DoD Live Provenance & Telemetry Audit Report (Endpoint #11)", "description": "Returns exact counts of REAL_LIVE_API, REAL_LOCAL_CAS, and SYNTHETIC_SEED across all 18 Silver & Gold tables, upstream live API HTTP telemetry, external portal Playwright probes, verified developer accounts, and zero_fake_dod_attestation.", "responses": {"200": {"description": "Tamper-evident Zero-Fake-DoD provenance audit report"}}}, "post": {"summary": "Zero-Fake-DoD Live Provenance & Telemetry Audit Report (POST)", "description": "Returns tamper-evident Zero-Fake-DoD provenance audit report.", "responses": {"200": {"description": "Tamper-evident Zero-Fake-DoD provenance audit report"}}}}, "/api/v1/data-api/maritime-live-ais-and-regulatory": {"x-relative-path": "/maritime-live-ais-and-regulatory", "get": {"summary": "Live Maritime AIS Vessels, Vessel Port Calls, Port Marine Weather & US Customs Regulatory Notices (Endpoint #12)", "description": "Queries SQLite Silver to return live vessel port calls (meri.digitraffic.fi/api/port-call/v1/port-calls), live AIS vessels (meri.digitraffic.fi/api/ais/v1/vessels), live port marine weather across 10 container hubs (marine-api.open-meteo.com/v1/marine), and live US Commerce/CBP/ITC regulatory & antidumping notices for Vietnam (federalregister.gov/api/v1/documents.json) with full wire_sha256 provenance and metered API key deduction.", "parameters": [{"name": "port_code", "in": "query", "schema": {"type": "string"}, "description": "Optional UN/LOCODE filter (e.g. VNSGN, NLRTM, FIHEL)"}, {"name": "vessel_name", "in": "query", "schema": {"type": "string"}, "description": "Optional vessel name substring filter"}, {"name": "keyword", "in": "query", "schema": {"type": "string"}, "description": "Optional keyword filter across vessels, ports, and regulatory notices"}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 25, "maximum": 200}, "description": "Max records per dataset (default 25)"}], "responses": {"200": {"description": "Live maritime AIS, port calls, marine weather, and regulatory customs notices with provenance summary"}, "401": {"description": "Invalid API key"}, "429": {"description": "Quota credits exhausted"}}}, "post": {"summary": "Live Maritime AIS Vessels, Vessel Port Calls, Port Marine Weather & US Customs Regulatory Notices (POST)", "description": "Accepts optional filters (port_code, vessel_name, keyword, limit) in JSON request body.", "responses": {"200": {"description": "Live maritime AIS, port calls, marine weather, and regulatory customs notices with provenance summary"}, "401": {"description": "Invalid API key"}, "429": {"description": "Quota credits exhausted"}}}}, "/api/v1/data-api/company-360": {"get": {"summary": "Unified Company-360 Counterparty, GLEIF L1/L2 Corporate Relationship, Shipment & Tariff Dossier (GET)", "description": "Returns a unified 360-degree corporate intelligence dossier combining GLEIF ISO 17442 Level-1/Level-2 corporate relationships, SEC EDGAR public filings, verified B2B compliance contacts, maritime port-call shipment manifests, and US Federal Register / CBP / BIS regulatory rulings with 100% SHA-256 wire provenance.", "parameters": [{"name": "q", "in": "query", "schema": {"type": "string"}, "description": "Company name, LEI code, CIK, country code, or keyword (e.g. Vietnam, Samsung, Maersk)"}, {"name": "country_code", "in": "query", "schema": {"type": "string"}, "description": "Optional ISO-2 country filter (e.g. VN, US, SG, NL, DE)"}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 25, "maximum": 100}, "description": "Max records per section (default 25)"}], "responses": {"200": {"description": "Unified Company-360 counterparty, shipment, contact, and regulatory dossier"}, "401": {"description": "Invalid API key"}, "429": {"description": "Quota credits exhausted"}}}, "post": {"summary": "Unified Company-360 Counterparty, GLEIF L1/L2 Corporate Relationship, Shipment & Tariff Dossier (POST)", "description": "Accepts query parameters (q, country_code, limit) in JSON request body.", "responses": {"200": {"description": "Unified Company-360 counterparty, shipment, contact, and regulatory dossier"}, "401": {"description": "Invalid API key"}, "429": {"description": "Quota credits exhausted"}}}}, "/api/v1/data-api/corridor-intelligence": {"get": {"summary": "Emerging & Global Bilateral Corridor Intelligence (India, Africa, ASEAN, EU, US)", "description": "Returns bilateral corridor merchandise trade flows, World Bank WDI applied tariff rates (TM.TAX.MRCH.WM.AR.ZS / TM.TAX.MANF.WM.AR.ZS), trade openness (NE.TRD.GNFS.ZS), container port throughput (IS.SHP.GOOD.TU), country macro metadata, and UN Comtrade HS6 reference structures with 100% 64-hex wire_sha256 provenance.", "parameters": [{"name": "corridor_tag", "in": "query", "schema": {"type": "string"}, "description": "Optional corridor filter (e.g. VN_INDIA, VN_AFRICA, SOUTH_ASIA, ASEAN_BASE)"}, {"name": "country_code", "in": "query", "schema": {"type": "string"}, "description": "Optional ISO2/ISO3 country code filter (e.g. IN, VN, NG, ZA, SG)"}, {"name": "hs_chapter", "in": "query", "schema": {"type": "string"}, "description": "Optional 2-digit HS chapter filter (e.g. 03, 10, 72, 85)"}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 25, "maximum": 200}, "description": "Max records per section"}], "responses": {"200": {"description": "Bilateral corridor intelligence & tariff/logistics metrics"}}}, "post": {"summary": "Emerging & Global Bilateral Corridor Intelligence (POST)", "responses": {"200": {"description": "Bilateral corridor intelligence & tariff/logistics metrics"}}}}, "/api/v1/data-api/importer-of-record-inference": {"get": {"summary": "Graph-Backed Importer-of-Record (IoR) & Counterparty Supply Chain Inference Engine", "description": "Cross-correlates GLEIF ISO-17442 Level-1/Level-2 legal entities, US SEC EDGAR public issuers, Vietnam/ASEAN customs declarations, TopSearch CAS trade dossiers, and US Federal Register / CBP / BIS regulatory determinations to compute a deterministic Importer-of-Record eligibility & confidence score.", "parameters": [{"name": "q", "in": "query", "schema": {"type": "string"}, "description": "Company name, LEI code, or keyword (e.g. Samsung, Vietnam, Maersk)"}, {"name": "hs_code", "in": "query", "schema": {"type": "string"}, "description": "Optional HS code affinity filter (e.g. 0901, 7208, 8517)"}, {"name": "country_code", "in": "query", "schema": {"type": "string"}, "description": "Optional ISO2 country filter"}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 25, "maximum": 200}, "description": "Max inferred counterparties"}], "responses": {"200": {"description": "Importer-of-Record inference results with confidence scores and wire_sha256"}}}, "post": {"summary": "Graph-Backed Importer-of-Record (IoR) & Counterparty Supply Chain Inference Engine (POST)", "responses": {"200": {"description": "Importer-of-Record inference results with confidence scores and wire_sha256"}}}}, "/api/v1/gti/live-search": {"post": {"summary": "Google-Omnibox Auto-Mode Global Trade Intelligence JSON-RPC Search", "description": "Auto-detects query intent across 5 modes (TARIFF, PORT, COMPANY, VESSEL, TRADE_FLOW) and returns sub-10ms SQLite-WAL Silver Lakehouse records with 64-hex wire_sha256.", "responses": {"200": {"description": "Auto-detected mode results with query_time_ms and wire_sha256"}}}}, "/api/v1/data-api/alternative-gap-closing-intelligence": {"get": {"summary": "Zero-Cost ($0) Alternative Gap-Closing Trade & Supply Chain Intelligence (502,895+ Real Records)", "description": "Synthesizes 8 zero-cost official government & intergovernmental data engines that replace $150K-$500K/yr commercial B/L feeds: Eurostat Bulk EU-27 Trade Flows (369,951 rows), UN Comtrade Deep HS2xPartner Flows (28,000 rows), SEC EDGAR + GLEIF L1/L2 Corporate Entities (12,634 rows), US Federal Register ITA/CBP/BIS/USITC Rulings & Importer/Exporter Declarations (11,765 + 8,172 rows), World Bank WDI Deep Macro/Tariff/LPI Series (6,068 rows), and Digitraffic AIS Reconstructed Maritime Trade Flows (4,893 rows) — 100% attested with 64-hex wire_sha256.", "parameters": [{"name": "q", "in": "query", "schema": {"type": "string"}, "description": "Optional search keyword across companies, rulings, vessels, or commodities"}, {"name": "country_code", "in": "query", "schema": {"type": "string"}, "description": "Optional ISO2 country filter (e.g. VN, US, DE, CN, JP, NL)"}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 15, "maximum": 100}, "description": "Max sample records per alternative engine"}], "responses": {"200": {"description": "Alternative gap-closing intelligence summary & attested records across all 39 tables"}}}, "post": {"summary": "Zero-Cost ($0) Alternative Gap-Closing Trade & Supply Chain Intelligence (POST)", "responses": {"200": {"description": "Alternative gap-closing intelligence summary & attested records across all 39 tables"}}}}, "/api/v1/data-api/subscription/lifecycle": {"get": {"summary": "E2E DaaS Subscription Lifecycle Management & Telemetry (GET)", "description": "Inspects subscriber DaaS lifecycle state, billing cycle, quota & overage policy, VAS 200 (TK 3387 -> TK 5113) / IFRS 15 financial schedule, and lifecycle event audit log.", "responses": {"200": {"description": "DaaS subscription lifecycle telemetry & audit history"}}}, "post": {"summary": "Execute E2E DaaS Subscription Lifecycle Action (POST)", "description": "Executes subscription lifecycle transitions: provision, upgrade (with daily proration credit), topup, configure (overage_policy hard_cap vs pay_as_you_go, webhook, ERP connector), rotate_key, suspend, reactivate, renew, cancel, settle_overage, telemetry, or history.", "responses": {"200": {"description": "Subscription lifecycle transition executed and SHA-256 attested"}}}}, "/api/v1/data-api/five-suite-daas-orchestration": {"get": {"summary": "5-Suite (AL2C, AS2P, AIFO, AFSM, AQMS) GTI Data API & TradeInt DaaS Orchestration (GET)", "description": "Executes and returns the unified 5-Suite Data-as-a-Service (DaaS) operating model across AL2C (CPQ, Subscription Ledger, 1C26TAA, Portal), AS2P (32-Shard Proxy/Modal FinOps COGS & 4-Way Match), AIFO (VAS 200 TK 3387/5113 & IFRS 15 Revenue Recognition, ARR/MRR/NRR/Rule of 40, TT13/2020 Tax Shield, Decree 13 PII), AFSM (32-Shard Lakehouse SRE Weibull RUL & SAP/Oracle/Odoo ERP Connector FSM), and AQMS (4-Gate Zero-Mock Quality Gatekeeper).", "responses": {"200": {"description": "Unified 5-Suite DaaS & TradeInt orchestration report"}}}, "post": {"summary": "5-Suite (AL2C, AS2P, AIFO, AFSM, AQMS) GTI Data API & TradeInt DaaS Orchestration (POST)", "responses": {"200": {"description": "Unified 5-Suite DaaS & TradeInt orchestration report"}}}}}}