{"openapi":"3.1.0","info":{"title":"JAPAN API STORE","description":"Production OpenAPI 3.1 contracts for four Global APIs and eight Japan-domestic APIs. Domestic operations use unified success/error envelopes and explicit AI tool-selection guidance; confidence is not a probability and is derived from explicit evidence and assumptions.","version":"1.0.0"},"components":{"securitySchemes":{"bearerApiKey":{"type":"http","scheme":"bearer","bearerFormat":"jap_live_<key_id>_<secret>","description":"Test or live JAPAN API STORE key. The full key is displayed only once at issuance."}},"schemas":{}},"paths":{"/openapi.json":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/health/live":{"get":{"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["status","service","request_id"],"properties":{"status":{"type":"string","enum":["ok"]},"service":{"type":"string"},"request_id":{"pattern":"^req_[a-f0-9]{32}$","type":"string"},"address_data":{"additionalProperties":false,"type":"object","required":["core","parcel","residential","dataset_version"],"properties":{"core":{"type":"string","enum":["ok"]},"parcel":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["disabled"]}]},"residential":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["disabled"]}]},"dataset_version":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}}}}},"/health/ready":{"get":{"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["status","service","request_id"],"properties":{"status":{"type":"string","enum":["ok"]},"service":{"type":"string"},"request_id":{"pattern":"^req_[a-f0-9]{32}$","type":"string"},"address_data":{"additionalProperties":false,"type":"object","required":["core","parcel","residential","dataset_version"],"properties":{"core":{"type":"string","enum":["ok"]},"parcel":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["disabled"]}]},"residential":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["disabled"]}]},"dataset_version":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}}}}},"/v1/address/resolve":{"post":{"summary":"Resolve one Japanese postal code or address","description":"Returns matched, partial, ambiguous, and not_found search outcomes as HTTP 200. confidence is not a probability.","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"description":"A single Japanese postal code or address query.","type":"object","required":["query"],"properties":{"query":{"minLength":1,"maxLength":512,"type":"string"}}}}},"description":"A single Japanese postal code or address query."},"security":[{"bearerApiKey":[]}],"responses":{"200":{"description":"Normalized address result. score is an evidence score; confidence is not a probability.","content":{"application/json":{"schema":{"additionalProperties":false,"description":"Normalized address result. score is an evidence score; confidence is not a probability.","type":"object","required":["request_id","success","input","result","match","warnings","candidates","data_versions","data_status"],"properties":{"request_id":{"pattern":"^req_[a-f0-9]{32}$","type":"string"},"success":{"type":"boolean","enum":[true]},"input":{"additionalProperties":false,"type":"object","required":["query","detected_type"],"properties":{"query":{"type":"string"},"detected_type":{"type":"string","enum":["address"]}}},"result":{"additionalProperties":false,"type":"object","required":["postal_code","source_address","verified_address","verification","normalized_address","kana","romaji","codes","location"],"properties":{"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"source_address":{"type":"string"},"verified_address":{"additionalProperties":false,"type":"object","required":["prefecture","municipality","town_area","kyoto_street","chome","block","lot","building_number","sub_number","building","building_name","room","full"],"properties":{"prefecture":{"anyOf":[{"type":"string"},{"type":"null"}]},"municipality":{"anyOf":[{"type":"string"},{"type":"null"}]},"town_area":{"anyOf":[{"type":"string"},{"type":"null"}]},"kyoto_street":{"anyOf":[{"type":"string"},{"type":"null"}]},"chome":{"anyOf":[{"type":"string"},{"type":"null"}]},"block":{"anyOf":[{"type":"string"},{"type":"null"}]},"lot":{"anyOf":[{"type":"string"},{"type":"null"}]},"building_number":{"anyOf":[{"type":"string"},{"type":"null"}]},"sub_number":{"anyOf":[{"type":"string"},{"type":"null"}]},"building":{"anyOf":[{"type":"string"},{"type":"null"}]},"building_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"room":{"anyOf":[{"type":"string"},{"type":"null"}]},"full":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"verification":{"additionalProperties":false,"type":"object","required":["verified_level","addressing_system","unresolved_components","providers"],"properties":{"verified_level":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["prefecture"]},{"type":"string","enum":["municipality"]},{"type":"string","enum":["machiaza"]},{"type":"string","enum":["block"]},{"type":"string","enum":["lot"]},{"type":"string","enum":["building"]},{"type":"string","enum":["residential_number"]}]},"addressing_system":{"anyOf":[{"type":"string","enum":["residential_address"]},{"type":"string","enum":["land_lot"]},{"type":"string","enum":["unknown"]}]},"unresolved_components":{"type":"array","items":{"type":"string"}},"public_data_status":{"anyOf":[{"type":"string","enum":["available"]},{"type":"string","enum":["public_data_not_available"]},{"type":"string","enum":["unknown"]}]},"conflict_detected":{"type":"boolean"},"providers":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["provider","source","source_type","verified_level","status"],"properties":{"provider":{"type":"string"},"source":{"type":"string"},"source_type":{"type":"string","enum":["government_open_data"]},"verified_level":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["prefecture"]},{"type":"string","enum":["municipality"]},{"type":"string","enum":["machiaza"]},{"type":"string","enum":["block"]},{"type":"string","enum":["lot"]},{"type":"string","enum":["building"]},{"type":"string","enum":["residential_number"]}]},"status":{"anyOf":[{"type":"string","enum":["stable"]},{"type":"string","enum":["preview"]},{"type":"string","enum":["partial"]},{"type":"string","enum":["unavailable"]}]}}}}}},"normalized_address":{"additionalProperties":false,"type":"object","required":["prefecture","municipality","town_area","kyoto_street","chome","block","lot","building_number","sub_number","building","building_name","room","full"],"properties":{"prefecture":{"anyOf":[{"type":"string"},{"type":"null"}]},"municipality":{"anyOf":[{"type":"string"},{"type":"null"}]},"town_area":{"anyOf":[{"type":"string"},{"type":"null"}]},"kyoto_street":{"anyOf":[{"type":"string"},{"type":"null"}]},"chome":{"anyOf":[{"type":"string"},{"type":"null"}]},"block":{"anyOf":[{"type":"string"},{"type":"null"}]},"lot":{"anyOf":[{"type":"string"},{"type":"null"}]},"building_number":{"anyOf":[{"type":"string"},{"type":"null"}]},"sub_number":{"anyOf":[{"type":"string"},{"type":"null"}]},"building":{"anyOf":[{"type":"string"},{"type":"null"}]},"building_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"room":{"anyOf":[{"type":"string"},{"type":"null"}]},"full":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"kana":{"additionalProperties":false,"type":"object","required":["prefecture","municipality","town_area"],"properties":{"prefecture":{"anyOf":[{"type":"string"},{"type":"null"}]},"municipality":{"anyOf":[{"type":"string"},{"type":"null"}]},"town_area":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"romaji":{"additionalProperties":false,"type":"object","required":["prefecture","municipality","town_area"],"properties":{"prefecture":{"anyOf":[{"type":"string"},{"type":"null"}]},"municipality":{"anyOf":[{"type":"string"},{"type":"null"}]},"town_area":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"codes":{"additionalProperties":false,"type":"object","required":["jis_code","machiaza_id","residential_block_id","residential_id","parcel_id"],"properties":{"jis_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"machiaza_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"residential_block_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"residential_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"parcel_id":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"location":{"additionalProperties":false,"type":"object","required":["latitude","longitude"],"properties":{"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"source":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}},"match":{"additionalProperties":false,"type":"object","required":["status","score","confidence","match_level","coordinate_level","unmatched_text"],"properties":{"status":{"anyOf":[{"type":"string","enum":["matched"]},{"type":"string","enum":["partial"]},{"type":"string","enum":["ambiguous"]},{"type":"string","enum":["not_found"]}]},"score":{"minimum":0,"maximum":1,"type":"number"},"confidence":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["medium"]},{"type":"string","enum":["low"]}]},"match_level":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["prefecture"]},{"type":"string","enum":["municipality"]},{"type":"string","enum":["machiaza"]},{"type":"string","enum":["machiaza_detail"]},{"type":"string","enum":["block"]},{"type":"string","enum":["residence"]},{"type":"string","enum":["residential_number"]},{"type":"string","enum":["parcel"]}]},"coordinate_level":{"anyOf":[{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["prefecture"]},{"type":"string","enum":["municipality"]},{"type":"string","enum":["machiaza"]},{"type":"string","enum":["machiaza_detail"]},{"type":"string","enum":["block"]},{"type":"string","enum":["residence"]},{"type":"string","enum":["residential_number"]},{"type":"string","enum":["parcel"]}]},{"type":"string","enum":["unavailable"]}]},"unmatched_text":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"warnings":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"anyOf":[{"type":"string","enum":["PARTIAL_ADDRESS_MATCH"]},{"type":"string","enum":["MULTIPLE_CANDIDATES"]},{"type":"string","enum":["COORDINATE_LOW_PRECISION"]},{"type":"string","enum":["PREVIEW_DATA_USED"]},{"type":"string","enum":["ROMAJI_UNAVAILABLE"]},{"type":"string","enum":["UNMATCHED_TEXT_REMAINS"]},{"type":"string","enum":["DATA_SOURCE_MISMATCH"]},{"type":"string","enum":["PUBLIC_SUBADDRESS_DATA_NOT_AVAILABLE"]}]},"message":{"type":"string"},"hint":{"type":"string"}}}},"candidates":{"maxItems":10,"type":"array","items":{"additionalProperties":false,"type":"object","required":["postal_code","normalized_address","kana","codes","match_level","coordinate_level","score"],"properties":{"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"normalized_address":{"additionalProperties":false,"type":"object","required":["prefecture","municipality","town_area","kyoto_street","chome","block","lot","building_number","sub_number","building","building_name","room","full"],"properties":{"prefecture":{"anyOf":[{"type":"string"},{"type":"null"}]},"municipality":{"anyOf":[{"type":"string"},{"type":"null"}]},"town_area":{"anyOf":[{"type":"string"},{"type":"null"}]},"kyoto_street":{"anyOf":[{"type":"string"},{"type":"null"}]},"chome":{"anyOf":[{"type":"string"},{"type":"null"}]},"block":{"anyOf":[{"type":"string"},{"type":"null"}]},"lot":{"anyOf":[{"type":"string"},{"type":"null"}]},"building_number":{"anyOf":[{"type":"string"},{"type":"null"}]},"sub_number":{"anyOf":[{"type":"string"},{"type":"null"}]},"building":{"anyOf":[{"type":"string"},{"type":"null"}]},"building_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"room":{"anyOf":[{"type":"string"},{"type":"null"}]},"full":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"kana":{"additionalProperties":false,"type":"object","required":["prefecture","municipality","town_area"],"properties":{"prefecture":{"anyOf":[{"type":"string"},{"type":"null"}]},"municipality":{"anyOf":[{"type":"string"},{"type":"null"}]},"town_area":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"codes":{"additionalProperties":false,"type":"object","required":["jis_code","machiaza_id","residential_block_id","residential_id","parcel_id"],"properties":{"jis_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"machiaza_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"residential_block_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"residential_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"parcel_id":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"match_level":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["prefecture"]},{"type":"string","enum":["municipality"]},{"type":"string","enum":["machiaza"]},{"type":"string","enum":["machiaza_detail"]},{"type":"string","enum":["block"]},{"type":"string","enum":["residence"]},{"type":"string","enum":["residential_number"]},{"type":"string","enum":["parcel"]}]},"coordinate_level":{"anyOf":[{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["prefecture"]},{"type":"string","enum":["municipality"]},{"type":"string","enum":["machiaza"]},{"type":"string","enum":["machiaza_detail"]},{"type":"string","enum":["block"]},{"type":"string","enum":["residence"]},{"type":"string","enum":["residential_number"]},{"type":"string","enum":["parcel"]}]},{"type":"string","enum":["unavailable"]}]},"score":{"minimum":0,"maximum":1,"type":"number"}}}},"data_versions":{"additionalProperties":false,"type":"object","required":["japan_post","abr","abr_database","normalizer"],"properties":{"japan_post":{"anyOf":[{"type":"string"},{"type":"null"}]},"abr":{"anyOf":[{"type":"string"},{"type":"null"}]},"abr_database":{"anyOf":[{"type":"string"},{"type":"null"}]},"normalizer":{"type":"string"}}},"data_status":{"additionalProperties":false,"type":"object","required":["overall","japan_post","abr"],"properties":{"overall":{"anyOf":[{"type":"string","enum":["stable"]},{"type":"string","enum":["preview"]},{"type":"string","enum":["partial"]}]},"japan_post":{"anyOf":[{"type":"string","enum":["stable"]},{"type":"string","enum":["preview"]},{"type":"string","enum":["partial"]},{"type":"string","enum":["unavailable"]}]},"abr":{"anyOf":[{"type":"string","enum":["stable"]},{"type":"string","enum":["preview"]},{"type":"string","enum":["partial"]},{"type":"string","enum":["unavailable"]}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}}}}},"/v1/business/demo":{"post":{"summary":"Run a rate-limited Business Mix public lookup","description":"Executes a bounded company-name, corporate-number, or T-prefixed qualified-invoice registration lookup without an API key. Requests are rate limited and queries are redacted from logs.","requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"additionalProperties":false,"type":"object","required":["example_id"],"properties":{"example_id":{"anyOf":[{"type":"string","enum":["toyota"]},{"type":"string","enum":["name_prefecture"]},{"type":"string","enum":["romaji_location"]},{"type":"string","enum":["corporate_number"]},{"type":"string","enum":["partial_name"]}]}}},{"additionalProperties":false,"type":"object","required":["query"],"properties":{"query":{"minLength":1,"maxLength":120,"description":"An English or romanized company name, or 13-digit corporate number, for the rate-limited public demo.","type":"string"}}}]}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"additionalProperties":false,"type":"object","required":["request_id","success","input","candidates","match","warnings","providers"],"properties":{"request_id":{"pattern":"^req_[a-f0-9]{32}$","type":"string"},"success":{"type":"boolean","enum":[true]},"input":{"additionalProperties":false,"type":"object","required":["query","normalized_query","detected_type","prefecture_filter"],"properties":{"query":{"type":"string"},"normalized_query":{"type":"string"},"detected_type":{"anyOf":[{"type":"string","enum":["company_name"]},{"type":"string","enum":["corporate_number"]},{"type":"string","enum":["address"]}]},"prefecture_filter":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"candidates":{"maxItems":20,"type":"array","items":{"additionalProperties":false,"type":"object","required":["corporate_number","official_name","normalized_name","english_name","entity_type","entity_type_label","entity_type_label_en","address","prefecture","municipality","corporate_type","corporate_type_en","corporate_type_position","match_score","match_type","search_aliases","source"],"properties":{"corporate_number":{"pattern":"^[0-9]{13}$","type":"string"},"official_name":{"type":"string"},"normalized_name":{"type":"string"},"english_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"entity_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"entity_type_label":{"anyOf":[{"type":"string"},{"type":"null"}]},"entity_type_label_en":{"anyOf":[{"type":"string"},{"type":"null"}]},"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"prefecture":{"anyOf":[{"type":"string"},{"type":"null"}]},"municipality":{"anyOf":[{"type":"string"},{"type":"null"}]},"corporate_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"corporate_type_en":{"anyOf":[{"type":"string"},{"type":"null"}]},"corporate_type_position":{"anyOf":[{"type":"string","enum":["prefix"]},{"type":"string","enum":["suffix"]},{"type":"string","enum":["none"]},{"type":"string","enum":["unknown"]}]},"match_score":{"minimum":0,"maximum":1,"type":"number"},"match_type":{"anyOf":[{"type":"string","enum":["exact"]},{"type":"string","enum":["prefix"]},{"type":"string","enum":["contains"]},{"type":"string","enum":["fuzzy"]}]},"search_aliases":{"type":"array","items":{"type":"string"}},"source":{"type":"string"}}}},"match":{"additionalProperties":false,"type":"object","required":["status","confidence","candidate_count"],"properties":{"status":{"anyOf":[{"type":"string","enum":["matched"]},{"type":"string","enum":["multiple_candidates"]},{"type":"string","enum":["not_found"]}]},"confidence":{"anyOf":[{"type":"string","enum":["exact"]},{"type":"string","enum":["high"]},{"type":"string","enum":["medium"]},{"type":"string","enum":["low"]},{"type":"string","enum":["unresolved"]}]},"candidate_count":{"minimum":0,"maximum":20,"type":"integer"}}},"warnings":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["provider","reason","message"],"properties":{"provider":{"type":"string"},"reason":{"type":"string"},"message":{"type":"string"}}}},"providers":{"additionalProperties":false,"type":"object","required":["nta","gbizinfo","estat","edinet","mlit_reinfolib","address_mix"],"properties":{"nta":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["connected"]},{"type":"string","enum":["error"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["timeout"]},{"type":"string","enum":["disabled"]}]},"gbizinfo":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["connected"]},{"type":"string","enum":["error"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["timeout"]},{"type":"string","enum":["disabled"]}]},"estat":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["connected"]},{"type":"string","enum":["error"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["timeout"]},{"type":"string","enum":["disabled"]}]},"edinet":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["connected"]},{"type":"string","enum":["error"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["timeout"]},{"type":"string","enum":["disabled"]}]},"mlit_reinfolib":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["connected"]},{"type":"string","enum":["error"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["timeout"]},{"type":"string","enum":["disabled"]}]},"address_mix":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["connected"]},{"type":"string","enum":["error"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["timeout"]},{"type":"string","enum":["disabled"]}]}}}},"title":"BusinessSearchResponse"},{"additionalProperties":false,"type":"object","required":["request_id","success","company","nta","invoice","address","business","corporate_group","surroundings","market_demographics","property_location","government_public","trust_signals","search_aliases","provenance","query","match","corporate","location","industry","registrations","financial","real_estate","sources","warnings","data_freshness","providers"],"properties":{"request_id":{"pattern":"^req_[a-f0-9]{32}$","type":"string"},"success":{"type":"boolean","enum":[true]},"company":{"additionalProperties":false,"type":"object","required":["available","reason","corporate_number","official_name","normalized_name","english_name","entity_type","entity_type_code","entity_type_label","entity_type_label_en","status","raw_status","furigana"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"corporate_number":{"pattern":"^[0-9]{13}$","type":"string"},"official_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"normalized_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"english_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"entity_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"entity_type_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"entity_type_label":{"anyOf":[{"type":"string"},{"type":"null"}]},"entity_type_label_en":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string"},{"type":"null"}]},"raw_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"furigana":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"nta":{"additionalProperties":false,"type":"object","required":["available","verified","status","corporate_number","official_name","address","assignment_date","update_date","change_date","close_date","checked_at","source"],"properties":{"available":{"type":"boolean"},"verified":{"type":"boolean"},"status":{"anyOf":[{"type":"string","enum":["verified"]},{"type":"string","enum":["official_directory"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["temporarily_unavailable"]},{"type":"string","enum":["disabled"]}]},"corporate_number":{"pattern":"^[0-9]{13}$","type":"string"},"official_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"assignment_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"update_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"change_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"close_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"checked_at":{"format":"date-time","type":"string"},"source":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"invoice":{"additionalProperties":false,"type":"object","required":["available","registered","valid","status","registration_number","registration_date","cancellation_date","expiration_date","update_date","name","address","checked_at","source"],"properties":{"available":{"type":"boolean"},"registered":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"valid":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["registered"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["expired"]},{"type":"string","enum":["not_registered"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["temporarily_unavailable"]},{"type":"string","enum":["disabled"]}]},"registration_number":{"pattern":"^T[0-9]{13}$","type":"string"},"registration_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"cancellation_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"expiration_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"update_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"checked_at":{"format":"date-time","type":"string"},"source":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"address":{"additionalProperties":false,"type":"object","required":["available","reason","input","normalized","postal_code","prefecture","city","municipality","town","machiaza","lot","sub_number","building","room","normalized_address","source_address","verified_address","verified_level","addressing_system","unresolved_components","latitude","longitude","address_code","resolution"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"input":{"anyOf":[{"type":"string"},{"type":"null"}]},"normalized":{"anyOf":[{"type":"string"},{"type":"null"}]},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"prefecture":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"municipality":{"anyOf":[{"type":"string"},{"type":"null"}]},"town":{"anyOf":[{"type":"string"},{"type":"null"}]},"machiaza":{"anyOf":[{"type":"string"},{"type":"null"}]},"lot":{"anyOf":[{"type":"string"},{"type":"null"}]},"sub_number":{"anyOf":[{"type":"string"},{"type":"null"}]},"building":{"anyOf":[{"type":"string"},{"type":"null"}]},"room":{"anyOf":[{"type":"string"},{"type":"null"}]},"normalized_address":{"anyOf":[{"type":"string"},{"type":"null"}]},"source_address":{"anyOf":[{"type":"string"},{"type":"null"}]},"verified_address":{"anyOf":[{"type":"string"},{"type":"null"}]},"verified_level":{"anyOf":[{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["prefecture"]},{"type":"string","enum":["municipality"]},{"type":"string","enum":["machiaza"]},{"type":"string","enum":["block"]},{"type":"string","enum":["lot"]},{"type":"string","enum":["building"]},{"type":"string","enum":["residential_number"]}]},{"type":"null"}]},"addressing_system":{"anyOf":[{"anyOf":[{"type":"string","enum":["residential_address"]},{"type":"string","enum":["land_lot"]},{"type":"string","enum":["unknown"]}]},{"type":"null"}]},"unresolved_components":{"type":"array","items":{"type":"string"}},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"address_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"resolution":{"additionalProperties":false,"type":"object","required":["match_status","confidence","match_level","coordinate_level","unmatched_text"],"properties":{"match_status":{"anyOf":[{"anyOf":[{"type":"string","enum":["matched"]},{"type":"string","enum":["partial"]},{"type":"string","enum":["ambiguous"]},{"type":"string","enum":["not_found"]}]},{"type":"null"}]},"confidence":{"anyOf":[{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["medium"]},{"type":"string","enum":["low"]}]},{"type":"null"}]},"match_level":{"anyOf":[{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["prefecture"]},{"type":"string","enum":["municipality"]},{"type":"string","enum":["machiaza"]},{"type":"string","enum":["machiaza_detail"]},{"type":"string","enum":["block"]},{"type":"string","enum":["residence"]},{"type":"string","enum":["residential_number"]},{"type":"string","enum":["parcel"]}]},{"type":"null"}]},"coordinate_level":{"anyOf":[{"anyOf":[{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["prefecture"]},{"type":"string","enum":["municipality"]},{"type":"string","enum":["machiaza"]},{"type":"string","enum":["machiaza_detail"]},{"type":"string","enum":["block"]},{"type":"string","enum":["residence"]},{"type":"string","enum":["residential_number"]},{"type":"string","enum":["parcel"]}]},{"type":"string","enum":["unavailable"]}]},{"type":"null"}]},"unmatched_text":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}},"business":{"additionalProperties":false,"type":"object","required":["available","reason","name","normalized_name","name_ja","official_name_en","romanized_name","romanized_name_status","corporate_type","corporate_type_en","corporate_type_position","business_status","industry","business_summary","employee_count","capital_stock","company_url"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"normalized_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"name_ja":{"anyOf":[{"type":"string"},{"type":"null"}]},"official_name_en":{"anyOf":[{"type":"string"},{"type":"null"}]},"romanized_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"romanized_name_status":{"anyOf":[{"type":"string","enum":["official"]},{"type":"string","enum":["generated"]},{"type":"string","enum":["unavailable"]}]},"corporate_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"corporate_type_en":{"anyOf":[{"type":"string"},{"type":"null"}]},"corporate_type_position":{"anyOf":[{"type":"string","enum":["prefix"]},{"type":"string","enum":["suffix"]},{"type":"string","enum":["none"]},{"type":"string","enum":["unknown"]}]},"business_status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["closed"]},{"type":"string","enum":["unknown"]}]},"industry":{"type":"array","items":{"type":"string"}},"business_summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"employee_count":{"anyOf":[{"type":"integer"},{"type":"null"}]},"capital_stock":{"anyOf":[{"type":"number"},{"type":"null"}]},"company_url":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"corporate_group":{"additionalProperties":false,"type":"object","required":["available","reason","group_name","as_of","coverage_note","disclosed_group_company_count","consolidated_subsidiary_count","equity_method_associate_joint_venture_count","members","sources"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"group_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}]},"coverage_note":{"type":"string"},"disclosed_group_company_count":{"minimum":0,"type":"integer"},"consolidated_subsidiary_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}]},"equity_method_associate_joint_venture_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}]},"members":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["name","english_name","relationship_type","established","business_summary","company_url"],"properties":{"name":{"type":"string"},"english_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"relationship_type":{"anyOf":[{"type":"string","enum":["official_group_company"]},{"type":"string","enum":["parent_company"]},{"type":"string","enum":["consolidated_subsidiary"]},{"type":"string","enum":["equity_method_affiliate"]},{"type":"string","enum":["other_related_company"]}]},"established":{"anyOf":[{"type":"string"},{"type":"null"}]},"business_summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"company_url":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"sources":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["title","url","as_of","retrieved_at"],"properties":{"title":{"type":"string"},"url":{"type":"string"},"as_of":{"type":"string"},"retrieved_at":{"format":"date-time","type":"string"}}}}}},"surroundings":{"additionalProperties":false,"type":"object","required":["available","reason","nearest_region","administrative_area","municipality_code","coordinate_level","regional_attributes","stations","facilities"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"nearest_region":{"anyOf":[{"type":"string"},{"type":"null"}]},"administrative_area":{"anyOf":[{"type":"string"},{"type":"null"}]},"municipality_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"coordinate_level":{"anyOf":[{"anyOf":[{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["prefecture"]},{"type":"string","enum":["municipality"]},{"type":"string","enum":["machiaza"]},{"type":"string","enum":["machiaza_detail"]},{"type":"string","enum":["block"]},{"type":"string","enum":["residence"]},{"type":"string","enum":["residential_number"]},{"type":"string","enum":["parcel"]}]},{"type":"string","enum":["unavailable"]}]},{"type":"null"}]},"regional_attributes":{"type":"array","items":{"type":"string"}},"stations":{"type":"array","items":{"type":"string"}},"facilities":{"type":"array","items":{"type":"string"}}}},"market_demographics":{"additionalProperties":false,"type":"object","required":["available","reason","population","households","age_distribution","area_statistics","reference_year","geographic_level","stats_table_ids","unknown_age"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"population":{"anyOf":[{"type":"number"},{"type":"null"}]},"households":{"anyOf":[{"type":"number"},{"type":"null"}]},"age_distribution":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["label","value"],"properties":{"label":{"type":"string"},"value":{"type":"number"}}}},"area_statistics":{"type":"object","additionalProperties":{"type":"number"}},"reference_year":{"anyOf":[{"type":"integer"},{"type":"null"}]},"geographic_level":{"anyOf":[{"type":"string","enum":["municipality"]},{"type":"string","enum":["prefecture"]},{"type":"string","enum":["national"]},{"type":"null"}]},"stats_table_ids":{"type":"object","additionalProperties":{"type":"string"}},"unknown_age":{"anyOf":[{"type":"number"},{"type":"null"}]}}},"property_location":{"additionalProperties":false,"type":"object","required":["available","reason","land_use","zoning","location_attributes","prefecture","municipality","building_coverage_ratio","floor_area_ratio"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"land_use":{"anyOf":[{"type":"string"},{"type":"null"}]},"zoning":{"anyOf":[{"type":"string"},{"type":"null"}]},"location_attributes":{"type":"array","items":{"type":"string"}},"prefecture":{"anyOf":[{"type":"string"},{"type":"null"}]},"municipality":{"anyOf":[{"type":"string"},{"type":"null"}]},"building_coverage_ratio":{"anyOf":[{"type":"number"},{"type":"null"}]},"floor_area_ratio":{"anyOf":[{"type":"number"},{"type":"null"}]}}},"government_public":{"additionalProperties":false,"type":"object","required":["available","reason","subsidies","procurements","certifications","commendations","patents","filings"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"subsidies":{"type":"array","items":{"type":"object","additionalProperties":{}}},"procurements":{"type":"array","items":{"type":"object","additionalProperties":{}}},"certifications":{"type":"array","items":{"type":"object","additionalProperties":{}}},"commendations":{"type":"array","items":{"type":"object","additionalProperties":{}}},"patents":{"type":"array","items":{"type":"object","additionalProperties":{}}},"filings":{"type":"array","items":{"type":"object","additionalProperties":{}}}}},"trust_signals":{"additionalProperties":false,"type":"object","required":["available","reason","corporate_information_verified","public_record_count","certification_count","procurement_count","subsidy_count","filing_count","patent_count","commendation_count","data_freshness","disclaimer"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"corporate_information_verified":{"type":"boolean"},"public_record_count":{"minimum":0,"type":"integer"},"certification_count":{"minimum":0,"type":"integer"},"procurement_count":{"minimum":0,"type":"integer"},"subsidy_count":{"minimum":0,"type":"integer"},"filing_count":{"minimum":0,"type":"integer"},"patent_count":{"minimum":0,"type":"integer"},"commendation_count":{"minimum":0,"type":"integer"},"data_freshness":{"additionalProperties":false,"type":"object","required":["available","reason","value"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"value":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"disclaimer":{"type":"string"}}},"search_aliases":{"additionalProperties":false,"type":"object","required":["available","reason","values"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"values":{"type":"array","items":{"type":"string"}}}},"provenance":{"additionalProperties":false,"type":"object","required":["available","reason","sources"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"sources":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["source","dataset","status","source_type","provider","fields","retrieved_at","last_updated","quality","confidence","fallback_used"],"properties":{"source":{"type":"string"},"dataset":{"type":"string"},"status":{"type":"string"},"source_type":{"anyOf":[{"type":"string","enum":["government_api"]},{"type":"string","enum":["government_open_data"]},{"type":"string","enum":["government_statistics"]},{"type":"string","enum":["japan_api_store"]},{"type":"string","enum":["official_company_disclosure"]}]},"provider":{"type":"string"},"fields":{"type":"array","items":{"type":"string"}},"retrieved_at":{"format":"date-time","type":"string"},"last_updated":{"anyOf":[{"type":"string"},{"type":"null"}]},"quality":{"anyOf":[{"type":"string","enum":["official"]},{"type":"string","enum":["derived"]},{"type":"string","enum":["unavailable"]}]},"confidence":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["medium"]},{"type":"string","enum":["low"]}]},"fallback_used":{"type":"boolean"}}}}}},"query":{"additionalProperties":false,"type":"object","required":["input","normalized","detected_type"],"properties":{"input":{"type":"string"},"normalized":{"type":"string"},"detected_type":{"anyOf":[{"type":"string","enum":["company_name"]},{"type":"string","enum":["corporate_number"]},{"type":"string","enum":["address"]}]}}},"match":{"additionalProperties":false,"type":"object","required":["status","confidence"],"properties":{"status":{"anyOf":[{"type":"string","enum":["matched"]},{"type":"string","enum":["partial"]},{"type":"string","enum":["not_found"]}]},"confidence":{"anyOf":[{"type":"string","enum":["exact"]},{"type":"string","enum":["high"]},{"type":"string","enum":["medium"]},{"type":"string","enum":["low"]},{"type":"string","enum":["unresolved"]}]}}},"corporate":{"additionalProperties":false,"type":"object","required":["available","reason","corporate_number","corporate_number_status","registration_status"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"corporate_number":{"anyOf":[{"pattern":"^[0-9]{13}$","type":"string"},{"type":"null"}]},"corporate_number_status":{"anyOf":[{"type":"string","enum":["verified"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["not_found"]}]},"registration_status":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"location":{"additionalProperties":false,"type":"object","required":["available","latitude","longitude","coordinate_level","coordinate_source"],"properties":{"available":{"type":"boolean"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"coordinate_level":{"anyOf":[{"anyOf":[{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["prefecture"]},{"type":"string","enum":["municipality"]},{"type":"string","enum":["machiaza"]},{"type":"string","enum":["machiaza_detail"]},{"type":"string","enum":["block"]},{"type":"string","enum":["residence"]},{"type":"string","enum":["residential_number"]},{"type":"string","enum":["parcel"]}]},{"type":"string","enum":["unavailable"]}]},{"type":"null"}]},"coordinate_source":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"industry":{"additionalProperties":false,"type":"object","required":["available","classifications","summary"],"properties":{"available":{"type":"boolean"},"classifications":{"type":"array","items":{"type":"string"}},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"registrations":{"additionalProperties":false,"type":"object","required":["available","certifications","commendations","procurements","subsidies","patents"],"properties":{"available":{"type":"boolean"},"certifications":{"type":"array","items":{"type":"object","additionalProperties":{}}},"commendations":{"type":"array","items":{"type":"object","additionalProperties":{}}},"procurements":{"type":"array","items":{"type":"object","additionalProperties":{}}},"subsidies":{"type":"array","items":{"type":"object","additionalProperties":{}}},"patents":{"type":"array","items":{"type":"object","additionalProperties":{}}}}},"financial":{"additionalProperties":false,"type":"object","required":["available","edinet_code","securities_code","filing_available","latest_filing","fiscal_period"],"properties":{"available":{"type":"boolean"},"edinet_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"securities_code":{"type":"null"},"filing_available":{"type":"boolean"},"latest_filing":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"fiscal_period":{"additionalProperties":false,"type":"object","required":["start","end"],"properties":{"start":{"anyOf":[{"type":"string"},{"type":"null"}]},"end":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}},"real_estate":{"additionalProperties":false,"type":"object","required":["scope","available","land_use","zoning","ownership_inferred"],"properties":{"scope":{"type":"string","enum":["address_area"]},"available":{"type":"boolean"},"land_use":{"anyOf":[{"type":"string"},{"type":"null"}]},"zoning":{"anyOf":[{"type":"string"},{"type":"null"}]},"ownership_inferred":{"type":"boolean","enum":[false]}}},"sources":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["source","dataset","status","source_type","provider","fields","retrieved_at","last_updated","quality","confidence","fallback_used"],"properties":{"source":{"type":"string"},"dataset":{"type":"string"},"status":{"type":"string"},"source_type":{"anyOf":[{"type":"string","enum":["government_api"]},{"type":"string","enum":["government_open_data"]},{"type":"string","enum":["government_statistics"]},{"type":"string","enum":["japan_api_store"]},{"type":"string","enum":["official_company_disclosure"]}]},"provider":{"type":"string"},"fields":{"type":"array","items":{"type":"string"}},"retrieved_at":{"format":"date-time","type":"string"},"last_updated":{"anyOf":[{"type":"string"},{"type":"null"}]},"quality":{"anyOf":[{"type":"string","enum":["official"]},{"type":"string","enum":["derived"]},{"type":"string","enum":["unavailable"]}]},"confidence":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["medium"]},{"type":"string","enum":["low"]}]},"fallback_used":{"type":"boolean"}}}},"warnings":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["provider","reason","message"],"properties":{"provider":{"type":"string"},"reason":{"type":"string"},"message":{"type":"string"}}}},"data_freshness":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"null"}]}},"providers":{"additionalProperties":false,"type":"object","required":["nta","gbizinfo","estat","edinet","mlit_reinfolib","address_mix"],"properties":{"nta":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["connected"]},{"type":"string","enum":["error"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["timeout"]},{"type":"string","enum":["disabled"]}]},"gbizinfo":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["connected"]},{"type":"string","enum":["error"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["timeout"]},{"type":"string","enum":["disabled"]}]},"estat":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["connected"]},{"type":"string","enum":["error"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["timeout"]},{"type":"string","enum":["disabled"]}]},"edinet":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["connected"]},{"type":"string","enum":["error"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["timeout"]},{"type":"string","enum":["disabled"]}]},"mlit_reinfolib":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["connected"]},{"type":"string","enum":["error"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["timeout"]},{"type":"string","enum":["disabled"]}]},"address_mix":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["connected"]},{"type":"string","enum":["error"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["timeout"]},{"type":"string","enum":["disabled"]}]}}}},"title":"BusinessMixResponse"}]}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}}}}},"/v1/business/search":{"get":{"summary":"Search Japanese companies by name, corporate number, or invoice registration number","description":"Supports partial names, legal-form variations, spacing, case differences, exact 13-digit corporate numbers, T-prefixed qualified-invoice registration numbers, and an optional prefecture filter.","parameters":[{"schema":{"minLength":1,"maxLength":120,"type":"string"},"examples":{"Toyota Motor Corporation":{"value":"Toyota Motor Corporation"},"Sony Group Corporation":{"value":"Sony Group Corporation"},"Nintendo Co., Ltd.":{"value":"Nintendo Co., Ltd."},"1180301018771":{"value":"1180301018771"},"T1180301018771":{"value":"T1180301018771"}},"in":"query","name":"q","required":true,"description":"English or romanized company name, romanized location, 13-digit corporate number, or T-prefixed qualified invoice registration number. Official Japanese details are returned in the response."},{"schema":{"minimum":1,"maximum":20,"default":10,"type":"integer"},"in":"query","name":"limit","required":false},{"schema":{"minLength":2,"maxLength":16,"type":"string"},"in":"query","name":"prefecture","required":false}],"security":[{"bearerApiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","input","candidates","match","warnings","providers"],"properties":{"request_id":{"pattern":"^req_[a-f0-9]{32}$","type":"string"},"success":{"type":"boolean","enum":[true]},"input":{"additionalProperties":false,"type":"object","required":["query","normalized_query","detected_type","prefecture_filter"],"properties":{"query":{"type":"string"},"normalized_query":{"type":"string"},"detected_type":{"anyOf":[{"type":"string","enum":["company_name"]},{"type":"string","enum":["corporate_number"]},{"type":"string","enum":["address"]}]},"prefecture_filter":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"candidates":{"maxItems":20,"type":"array","items":{"additionalProperties":false,"type":"object","required":["corporate_number","official_name","normalized_name","english_name","entity_type","entity_type_label","entity_type_label_en","address","prefecture","municipality","corporate_type","corporate_type_en","corporate_type_position","match_score","match_type","search_aliases","source"],"properties":{"corporate_number":{"pattern":"^[0-9]{13}$","type":"string"},"official_name":{"type":"string"},"normalized_name":{"type":"string"},"english_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"entity_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"entity_type_label":{"anyOf":[{"type":"string"},{"type":"null"}]},"entity_type_label_en":{"anyOf":[{"type":"string"},{"type":"null"}]},"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"prefecture":{"anyOf":[{"type":"string"},{"type":"null"}]},"municipality":{"anyOf":[{"type":"string"},{"type":"null"}]},"corporate_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"corporate_type_en":{"anyOf":[{"type":"string"},{"type":"null"}]},"corporate_type_position":{"anyOf":[{"type":"string","enum":["prefix"]},{"type":"string","enum":["suffix"]},{"type":"string","enum":["none"]},{"type":"string","enum":["unknown"]}]},"match_score":{"minimum":0,"maximum":1,"type":"number"},"match_type":{"anyOf":[{"type":"string","enum":["exact"]},{"type":"string","enum":["prefix"]},{"type":"string","enum":["contains"]},{"type":"string","enum":["fuzzy"]}]},"search_aliases":{"type":"array","items":{"type":"string"}},"source":{"type":"string"}}}},"match":{"additionalProperties":false,"type":"object","required":["status","confidence","candidate_count"],"properties":{"status":{"anyOf":[{"type":"string","enum":["matched"]},{"type":"string","enum":["multiple_candidates"]},{"type":"string","enum":["not_found"]}]},"confidence":{"anyOf":[{"type":"string","enum":["exact"]},{"type":"string","enum":["high"]},{"type":"string","enum":["medium"]},{"type":"string","enum":["low"]},{"type":"string","enum":["unresolved"]}]},"candidate_count":{"minimum":0,"maximum":20,"type":"integer"}}},"warnings":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["provider","reason","message"],"properties":{"provider":{"type":"string"},"reason":{"type":"string"},"message":{"type":"string"}}}},"providers":{"additionalProperties":false,"type":"object","required":["nta","gbizinfo","estat","edinet","mlit_reinfolib","address_mix"],"properties":{"nta":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["connected"]},{"type":"string","enum":["error"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["timeout"]},{"type":"string","enum":["disabled"]}]},"gbizinfo":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["connected"]},{"type":"string","enum":["error"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["timeout"]},{"type":"string","enum":["disabled"]}]},"estat":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["connected"]},{"type":"string","enum":["error"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["timeout"]},{"type":"string","enum":["disabled"]}]},"edinet":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["connected"]},{"type":"string","enum":["error"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["timeout"]},{"type":"string","enum":["disabled"]}]},"mlit_reinfolib":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["connected"]},{"type":"string","enum":["error"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["timeout"]},{"type":"string","enum":["disabled"]}]},"address_mix":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["connected"]},{"type":"string","enum":["error"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["timeout"]},{"type":"string","enum":["disabled"]}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}}}}},"/v1/business/resolve":{"get":{"summary":"Resolve a Japanese business from one developer-friendly query","description":"Returns a complete Business Mix response with official National Tax Agency corporate and qualified-invoice verification for one unambiguous company, or bounded candidates when the query is ambiguous or not found.","parameters":[{"schema":{"minLength":1,"maxLength":120,"type":"string"},"examples":{"Toyota Motor Corporation":{"value":"Toyota Motor Corporation"},"Sony Group Corporation":{"value":"Sony Group Corporation"},"Nintendo Co., Ltd.":{"value":"Nintendo Co., Ltd."},"1180301018771":{"value":"1180301018771"},"T1180301018771":{"value":"T1180301018771"}},"in":"query","name":"q","required":true,"description":"English or romanized company name, romanized location, 13-digit corporate number, or T-prefixed qualified invoice registration number. Official Japanese details are returned in the response."},{"schema":{"minimum":1,"maximum":20,"default":10,"type":"integer"},"in":"query","name":"limit","required":false},{"schema":{"minLength":2,"maxLength":16,"type":"string"},"in":"query","name":"prefecture","required":false}],"security":[{"bearerApiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"additionalProperties":false,"type":"object","required":["request_id","success","input","candidates","match","warnings","providers"],"properties":{"request_id":{"pattern":"^req_[a-f0-9]{32}$","type":"string"},"success":{"type":"boolean","enum":[true]},"input":{"additionalProperties":false,"type":"object","required":["query","normalized_query","detected_type","prefecture_filter"],"properties":{"query":{"type":"string"},"normalized_query":{"type":"string"},"detected_type":{"anyOf":[{"type":"string","enum":["company_name"]},{"type":"string","enum":["corporate_number"]},{"type":"string","enum":["address"]}]},"prefecture_filter":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"candidates":{"maxItems":20,"type":"array","items":{"additionalProperties":false,"type":"object","required":["corporate_number","official_name","normalized_name","english_name","entity_type","entity_type_label","entity_type_label_en","address","prefecture","municipality","corporate_type","corporate_type_en","corporate_type_position","match_score","match_type","search_aliases","source"],"properties":{"corporate_number":{"pattern":"^[0-9]{13}$","type":"string"},"official_name":{"type":"string"},"normalized_name":{"type":"string"},"english_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"entity_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"entity_type_label":{"anyOf":[{"type":"string"},{"type":"null"}]},"entity_type_label_en":{"anyOf":[{"type":"string"},{"type":"null"}]},"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"prefecture":{"anyOf":[{"type":"string"},{"type":"null"}]},"municipality":{"anyOf":[{"type":"string"},{"type":"null"}]},"corporate_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"corporate_type_en":{"anyOf":[{"type":"string"},{"type":"null"}]},"corporate_type_position":{"anyOf":[{"type":"string","enum":["prefix"]},{"type":"string","enum":["suffix"]},{"type":"string","enum":["none"]},{"type":"string","enum":["unknown"]}]},"match_score":{"minimum":0,"maximum":1,"type":"number"},"match_type":{"anyOf":[{"type":"string","enum":["exact"]},{"type":"string","enum":["prefix"]},{"type":"string","enum":["contains"]},{"type":"string","enum":["fuzzy"]}]},"search_aliases":{"type":"array","items":{"type":"string"}},"source":{"type":"string"}}}},"match":{"additionalProperties":false,"type":"object","required":["status","confidence","candidate_count"],"properties":{"status":{"anyOf":[{"type":"string","enum":["matched"]},{"type":"string","enum":["multiple_candidates"]},{"type":"string","enum":["not_found"]}]},"confidence":{"anyOf":[{"type":"string","enum":["exact"]},{"type":"string","enum":["high"]},{"type":"string","enum":["medium"]},{"type":"string","enum":["low"]},{"type":"string","enum":["unresolved"]}]},"candidate_count":{"minimum":0,"maximum":20,"type":"integer"}}},"warnings":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["provider","reason","message"],"properties":{"provider":{"type":"string"},"reason":{"type":"string"},"message":{"type":"string"}}}},"providers":{"additionalProperties":false,"type":"object","required":["nta","gbizinfo","estat","edinet","mlit_reinfolib","address_mix"],"properties":{"nta":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["connected"]},{"type":"string","enum":["error"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["timeout"]},{"type":"string","enum":["disabled"]}]},"gbizinfo":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["connected"]},{"type":"string","enum":["error"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["timeout"]},{"type":"string","enum":["disabled"]}]},"estat":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["connected"]},{"type":"string","enum":["error"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["timeout"]},{"type":"string","enum":["disabled"]}]},"edinet":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["connected"]},{"type":"string","enum":["error"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["timeout"]},{"type":"string","enum":["disabled"]}]},"mlit_reinfolib":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["connected"]},{"type":"string","enum":["error"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["timeout"]},{"type":"string","enum":["disabled"]}]},"address_mix":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["connected"]},{"type":"string","enum":["error"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["timeout"]},{"type":"string","enum":["disabled"]}]}}}}},{"additionalProperties":false,"type":"object","required":["request_id","success","company","nta","invoice","address","business","corporate_group","surroundings","market_demographics","property_location","government_public","trust_signals","search_aliases","provenance","query","match","corporate","location","industry","registrations","financial","real_estate","sources","warnings","data_freshness","providers"],"properties":{"request_id":{"pattern":"^req_[a-f0-9]{32}$","type":"string"},"success":{"type":"boolean","enum":[true]},"company":{"additionalProperties":false,"type":"object","required":["available","reason","corporate_number","official_name","normalized_name","english_name","entity_type","entity_type_code","entity_type_label","entity_type_label_en","status","raw_status","furigana"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"corporate_number":{"pattern":"^[0-9]{13}$","type":"string"},"official_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"normalized_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"english_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"entity_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"entity_type_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"entity_type_label":{"anyOf":[{"type":"string"},{"type":"null"}]},"entity_type_label_en":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string"},{"type":"null"}]},"raw_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"furigana":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"nta":{"additionalProperties":false,"type":"object","required":["available","verified","status","corporate_number","official_name","address","assignment_date","update_date","change_date","close_date","checked_at","source"],"properties":{"available":{"type":"boolean"},"verified":{"type":"boolean"},"status":{"anyOf":[{"type":"string","enum":["verified"]},{"type":"string","enum":["official_directory"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["temporarily_unavailable"]},{"type":"string","enum":["disabled"]}]},"corporate_number":{"pattern":"^[0-9]{13}$","type":"string"},"official_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"assignment_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"update_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"change_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"close_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"checked_at":{"format":"date-time","type":"string"},"source":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"invoice":{"additionalProperties":false,"type":"object","required":["available","registered","valid","status","registration_number","registration_date","cancellation_date","expiration_date","update_date","name","address","checked_at","source"],"properties":{"available":{"type":"boolean"},"registered":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"valid":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["registered"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["expired"]},{"type":"string","enum":["not_registered"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["temporarily_unavailable"]},{"type":"string","enum":["disabled"]}]},"registration_number":{"pattern":"^T[0-9]{13}$","type":"string"},"registration_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"cancellation_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"expiration_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"update_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"checked_at":{"format":"date-time","type":"string"},"source":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"address":{"additionalProperties":false,"type":"object","required":["available","reason","input","normalized","postal_code","prefecture","city","municipality","town","machiaza","lot","sub_number","building","room","normalized_address","source_address","verified_address","verified_level","addressing_system","unresolved_components","latitude","longitude","address_code","resolution"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"input":{"anyOf":[{"type":"string"},{"type":"null"}]},"normalized":{"anyOf":[{"type":"string"},{"type":"null"}]},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"prefecture":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"municipality":{"anyOf":[{"type":"string"},{"type":"null"}]},"town":{"anyOf":[{"type":"string"},{"type":"null"}]},"machiaza":{"anyOf":[{"type":"string"},{"type":"null"}]},"lot":{"anyOf":[{"type":"string"},{"type":"null"}]},"sub_number":{"anyOf":[{"type":"string"},{"type":"null"}]},"building":{"anyOf":[{"type":"string"},{"type":"null"}]},"room":{"anyOf":[{"type":"string"},{"type":"null"}]},"normalized_address":{"anyOf":[{"type":"string"},{"type":"null"}]},"source_address":{"anyOf":[{"type":"string"},{"type":"null"}]},"verified_address":{"anyOf":[{"type":"string"},{"type":"null"}]},"verified_level":{"anyOf":[{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["prefecture"]},{"type":"string","enum":["municipality"]},{"type":"string","enum":["machiaza"]},{"type":"string","enum":["block"]},{"type":"string","enum":["lot"]},{"type":"string","enum":["building"]},{"type":"string","enum":["residential_number"]}]},{"type":"null"}]},"addressing_system":{"anyOf":[{"anyOf":[{"type":"string","enum":["residential_address"]},{"type":"string","enum":["land_lot"]},{"type":"string","enum":["unknown"]}]},{"type":"null"}]},"unresolved_components":{"type":"array","items":{"type":"string"}},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"address_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"resolution":{"additionalProperties":false,"type":"object","required":["match_status","confidence","match_level","coordinate_level","unmatched_text"],"properties":{"match_status":{"anyOf":[{"anyOf":[{"type":"string","enum":["matched"]},{"type":"string","enum":["partial"]},{"type":"string","enum":["ambiguous"]},{"type":"string","enum":["not_found"]}]},{"type":"null"}]},"confidence":{"anyOf":[{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["medium"]},{"type":"string","enum":["low"]}]},{"type":"null"}]},"match_level":{"anyOf":[{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["prefecture"]},{"type":"string","enum":["municipality"]},{"type":"string","enum":["machiaza"]},{"type":"string","enum":["machiaza_detail"]},{"type":"string","enum":["block"]},{"type":"string","enum":["residence"]},{"type":"string","enum":["residential_number"]},{"type":"string","enum":["parcel"]}]},{"type":"null"}]},"coordinate_level":{"anyOf":[{"anyOf":[{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["prefecture"]},{"type":"string","enum":["municipality"]},{"type":"string","enum":["machiaza"]},{"type":"string","enum":["machiaza_detail"]},{"type":"string","enum":["block"]},{"type":"string","enum":["residence"]},{"type":"string","enum":["residential_number"]},{"type":"string","enum":["parcel"]}]},{"type":"string","enum":["unavailable"]}]},{"type":"null"}]},"unmatched_text":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}},"business":{"additionalProperties":false,"type":"object","required":["available","reason","name","normalized_name","name_ja","official_name_en","romanized_name","romanized_name_status","corporate_type","corporate_type_en","corporate_type_position","business_status","industry","business_summary","employee_count","capital_stock","company_url"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"normalized_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"name_ja":{"anyOf":[{"type":"string"},{"type":"null"}]},"official_name_en":{"anyOf":[{"type":"string"},{"type":"null"}]},"romanized_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"romanized_name_status":{"anyOf":[{"type":"string","enum":["official"]},{"type":"string","enum":["generated"]},{"type":"string","enum":["unavailable"]}]},"corporate_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"corporate_type_en":{"anyOf":[{"type":"string"},{"type":"null"}]},"corporate_type_position":{"anyOf":[{"type":"string","enum":["prefix"]},{"type":"string","enum":["suffix"]},{"type":"string","enum":["none"]},{"type":"string","enum":["unknown"]}]},"business_status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["closed"]},{"type":"string","enum":["unknown"]}]},"industry":{"type":"array","items":{"type":"string"}},"business_summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"employee_count":{"anyOf":[{"type":"integer"},{"type":"null"}]},"capital_stock":{"anyOf":[{"type":"number"},{"type":"null"}]},"company_url":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"corporate_group":{"additionalProperties":false,"type":"object","required":["available","reason","group_name","as_of","coverage_note","disclosed_group_company_count","consolidated_subsidiary_count","equity_method_associate_joint_venture_count","members","sources"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"group_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}]},"coverage_note":{"type":"string"},"disclosed_group_company_count":{"minimum":0,"type":"integer"},"consolidated_subsidiary_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}]},"equity_method_associate_joint_venture_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}]},"members":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["name","english_name","relationship_type","established","business_summary","company_url"],"properties":{"name":{"type":"string"},"english_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"relationship_type":{"anyOf":[{"type":"string","enum":["official_group_company"]},{"type":"string","enum":["parent_company"]},{"type":"string","enum":["consolidated_subsidiary"]},{"type":"string","enum":["equity_method_affiliate"]},{"type":"string","enum":["other_related_company"]}]},"established":{"anyOf":[{"type":"string"},{"type":"null"}]},"business_summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"company_url":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"sources":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["title","url","as_of","retrieved_at"],"properties":{"title":{"type":"string"},"url":{"type":"string"},"as_of":{"type":"string"},"retrieved_at":{"format":"date-time","type":"string"}}}}}},"surroundings":{"additionalProperties":false,"type":"object","required":["available","reason","nearest_region","administrative_area","municipality_code","coordinate_level","regional_attributes","stations","facilities"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"nearest_region":{"anyOf":[{"type":"string"},{"type":"null"}]},"administrative_area":{"anyOf":[{"type":"string"},{"type":"null"}]},"municipality_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"coordinate_level":{"anyOf":[{"anyOf":[{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["prefecture"]},{"type":"string","enum":["municipality"]},{"type":"string","enum":["machiaza"]},{"type":"string","enum":["machiaza_detail"]},{"type":"string","enum":["block"]},{"type":"string","enum":["residence"]},{"type":"string","enum":["residential_number"]},{"type":"string","enum":["parcel"]}]},{"type":"string","enum":["unavailable"]}]},{"type":"null"}]},"regional_attributes":{"type":"array","items":{"type":"string"}},"stations":{"type":"array","items":{"type":"string"}},"facilities":{"type":"array","items":{"type":"string"}}}},"market_demographics":{"additionalProperties":false,"type":"object","required":["available","reason","population","households","age_distribution","area_statistics","reference_year","geographic_level","stats_table_ids","unknown_age"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"population":{"anyOf":[{"type":"number"},{"type":"null"}]},"households":{"anyOf":[{"type":"number"},{"type":"null"}]},"age_distribution":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["label","value"],"properties":{"label":{"type":"string"},"value":{"type":"number"}}}},"area_statistics":{"type":"object","additionalProperties":{"type":"number"}},"reference_year":{"anyOf":[{"type":"integer"},{"type":"null"}]},"geographic_level":{"anyOf":[{"type":"string","enum":["municipality"]},{"type":"string","enum":["prefecture"]},{"type":"string","enum":["national"]},{"type":"null"}]},"stats_table_ids":{"type":"object","additionalProperties":{"type":"string"}},"unknown_age":{"anyOf":[{"type":"number"},{"type":"null"}]}}},"property_location":{"additionalProperties":false,"type":"object","required":["available","reason","land_use","zoning","location_attributes","prefecture","municipality","building_coverage_ratio","floor_area_ratio"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"land_use":{"anyOf":[{"type":"string"},{"type":"null"}]},"zoning":{"anyOf":[{"type":"string"},{"type":"null"}]},"location_attributes":{"type":"array","items":{"type":"string"}},"prefecture":{"anyOf":[{"type":"string"},{"type":"null"}]},"municipality":{"anyOf":[{"type":"string"},{"type":"null"}]},"building_coverage_ratio":{"anyOf":[{"type":"number"},{"type":"null"}]},"floor_area_ratio":{"anyOf":[{"type":"number"},{"type":"null"}]}}},"government_public":{"additionalProperties":false,"type":"object","required":["available","reason","subsidies","procurements","certifications","commendations","patents","filings"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"subsidies":{"type":"array","items":{"type":"object","additionalProperties":{}}},"procurements":{"type":"array","items":{"type":"object","additionalProperties":{}}},"certifications":{"type":"array","items":{"type":"object","additionalProperties":{}}},"commendations":{"type":"array","items":{"type":"object","additionalProperties":{}}},"patents":{"type":"array","items":{"type":"object","additionalProperties":{}}},"filings":{"type":"array","items":{"type":"object","additionalProperties":{}}}}},"trust_signals":{"additionalProperties":false,"type":"object","required":["available","reason","corporate_information_verified","public_record_count","certification_count","procurement_count","subsidy_count","filing_count","patent_count","commendation_count","data_freshness","disclaimer"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"corporate_information_verified":{"type":"boolean"},"public_record_count":{"minimum":0,"type":"integer"},"certification_count":{"minimum":0,"type":"integer"},"procurement_count":{"minimum":0,"type":"integer"},"subsidy_count":{"minimum":0,"type":"integer"},"filing_count":{"minimum":0,"type":"integer"},"patent_count":{"minimum":0,"type":"integer"},"commendation_count":{"minimum":0,"type":"integer"},"data_freshness":{"additionalProperties":false,"type":"object","required":["available","reason","value"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"value":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"disclaimer":{"type":"string"}}},"search_aliases":{"additionalProperties":false,"type":"object","required":["available","reason","values"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"values":{"type":"array","items":{"type":"string"}}}},"provenance":{"additionalProperties":false,"type":"object","required":["available","reason","sources"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"sources":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["source","dataset","status","source_type","provider","fields","retrieved_at","last_updated","quality","confidence","fallback_used"],"properties":{"source":{"type":"string"},"dataset":{"type":"string"},"status":{"type":"string"},"source_type":{"anyOf":[{"type":"string","enum":["government_api"]},{"type":"string","enum":["government_open_data"]},{"type":"string","enum":["government_statistics"]},{"type":"string","enum":["japan_api_store"]},{"type":"string","enum":["official_company_disclosure"]}]},"provider":{"type":"string"},"fields":{"type":"array","items":{"type":"string"}},"retrieved_at":{"format":"date-time","type":"string"},"last_updated":{"anyOf":[{"type":"string"},{"type":"null"}]},"quality":{"anyOf":[{"type":"string","enum":["official"]},{"type":"string","enum":["derived"]},{"type":"string","enum":["unavailable"]}]},"confidence":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["medium"]},{"type":"string","enum":["low"]}]},"fallback_used":{"type":"boolean"}}}}}},"query":{"additionalProperties":false,"type":"object","required":["input","normalized","detected_type"],"properties":{"input":{"type":"string"},"normalized":{"type":"string"},"detected_type":{"anyOf":[{"type":"string","enum":["company_name"]},{"type":"string","enum":["corporate_number"]},{"type":"string","enum":["address"]}]}}},"match":{"additionalProperties":false,"type":"object","required":["status","confidence"],"properties":{"status":{"anyOf":[{"type":"string","enum":["matched"]},{"type":"string","enum":["partial"]},{"type":"string","enum":["not_found"]}]},"confidence":{"anyOf":[{"type":"string","enum":["exact"]},{"type":"string","enum":["high"]},{"type":"string","enum":["medium"]},{"type":"string","enum":["low"]},{"type":"string","enum":["unresolved"]}]}}},"corporate":{"additionalProperties":false,"type":"object","required":["available","reason","corporate_number","corporate_number_status","registration_status"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"corporate_number":{"anyOf":[{"pattern":"^[0-9]{13}$","type":"string"},{"type":"null"}]},"corporate_number_status":{"anyOf":[{"type":"string","enum":["verified"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["not_found"]}]},"registration_status":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"location":{"additionalProperties":false,"type":"object","required":["available","latitude","longitude","coordinate_level","coordinate_source"],"properties":{"available":{"type":"boolean"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"coordinate_level":{"anyOf":[{"anyOf":[{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["prefecture"]},{"type":"string","enum":["municipality"]},{"type":"string","enum":["machiaza"]},{"type":"string","enum":["machiaza_detail"]},{"type":"string","enum":["block"]},{"type":"string","enum":["residence"]},{"type":"string","enum":["residential_number"]},{"type":"string","enum":["parcel"]}]},{"type":"string","enum":["unavailable"]}]},{"type":"null"}]},"coordinate_source":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"industry":{"additionalProperties":false,"type":"object","required":["available","classifications","summary"],"properties":{"available":{"type":"boolean"},"classifications":{"type":"array","items":{"type":"string"}},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"registrations":{"additionalProperties":false,"type":"object","required":["available","certifications","commendations","procurements","subsidies","patents"],"properties":{"available":{"type":"boolean"},"certifications":{"type":"array","items":{"type":"object","additionalProperties":{}}},"commendations":{"type":"array","items":{"type":"object","additionalProperties":{}}},"procurements":{"type":"array","items":{"type":"object","additionalProperties":{}}},"subsidies":{"type":"array","items":{"type":"object","additionalProperties":{}}},"patents":{"type":"array","items":{"type":"object","additionalProperties":{}}}}},"financial":{"additionalProperties":false,"type":"object","required":["available","edinet_code","securities_code","filing_available","latest_filing","fiscal_period"],"properties":{"available":{"type":"boolean"},"edinet_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"securities_code":{"type":"null"},"filing_available":{"type":"boolean"},"latest_filing":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"fiscal_period":{"additionalProperties":false,"type":"object","required":["start","end"],"properties":{"start":{"anyOf":[{"type":"string"},{"type":"null"}]},"end":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}},"real_estate":{"additionalProperties":false,"type":"object","required":["scope","available","land_use","zoning","ownership_inferred"],"properties":{"scope":{"type":"string","enum":["address_area"]},"available":{"type":"boolean"},"land_use":{"anyOf":[{"type":"string"},{"type":"null"}]},"zoning":{"anyOf":[{"type":"string"},{"type":"null"}]},"ownership_inferred":{"type":"boolean","enum":[false]}}},"sources":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["source","dataset","status","source_type","provider","fields","retrieved_at","last_updated","quality","confidence","fallback_used"],"properties":{"source":{"type":"string"},"dataset":{"type":"string"},"status":{"type":"string"},"source_type":{"anyOf":[{"type":"string","enum":["government_api"]},{"type":"string","enum":["government_open_data"]},{"type":"string","enum":["government_statistics"]},{"type":"string","enum":["japan_api_store"]},{"type":"string","enum":["official_company_disclosure"]}]},"provider":{"type":"string"},"fields":{"type":"array","items":{"type":"string"}},"retrieved_at":{"format":"date-time","type":"string"},"last_updated":{"anyOf":[{"type":"string"},{"type":"null"}]},"quality":{"anyOf":[{"type":"string","enum":["official"]},{"type":"string","enum":["derived"]},{"type":"string","enum":["unavailable"]}]},"confidence":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["medium"]},{"type":"string","enum":["low"]}]},"fallback_used":{"type":"boolean"}}}},"warnings":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["provider","reason","message"],"properties":{"provider":{"type":"string"},"reason":{"type":"string"},"message":{"type":"string"}}}},"data_freshness":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"null"}]}},"providers":{"additionalProperties":false,"type":"object","required":["nta","gbizinfo","estat","edinet","mlit_reinfolib","address_mix"],"properties":{"nta":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["connected"]},{"type":"string","enum":["error"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["timeout"]},{"type":"string","enum":["disabled"]}]},"gbizinfo":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["connected"]},{"type":"string","enum":["error"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["timeout"]},{"type":"string","enum":["disabled"]}]},"estat":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["connected"]},{"type":"string","enum":["error"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["timeout"]},{"type":"string","enum":["disabled"]}]},"edinet":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["connected"]},{"type":"string","enum":["error"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["timeout"]},{"type":"string","enum":["disabled"]}]},"mlit_reinfolib":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["connected"]},{"type":"string","enum":["error"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["timeout"]},{"type":"string","enum":["disabled"]}]},"address_mix":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["connected"]},{"type":"string","enum":["error"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["timeout"]},{"type":"string","enum":["disabled"]}]}}}}}]}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}}}}},"/v1/business/{corporate_number}":{"get":{"summary":"Resolve one Japanese company into a Business Mix response","description":"Returns all existing Business Mix categories plus official National Tax Agency corporate and qualified-invoice verification, with explicit availability reasons and no AI-filled facts.","parameters":[{"schema":{"pattern":"^[0-9]{13}$","type":"string"},"in":"path","name":"corporate_number","required":true}],"security":[{"bearerApiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","company","nta","invoice","address","business","corporate_group","surroundings","market_demographics","property_location","government_public","trust_signals","search_aliases","provenance","query","match","corporate","location","industry","registrations","financial","real_estate","sources","warnings","data_freshness","providers"],"properties":{"request_id":{"pattern":"^req_[a-f0-9]{32}$","type":"string"},"success":{"type":"boolean","enum":[true]},"company":{"additionalProperties":false,"type":"object","required":["available","reason","corporate_number","official_name","normalized_name","english_name","entity_type","entity_type_code","entity_type_label","entity_type_label_en","status","raw_status","furigana"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"corporate_number":{"pattern":"^[0-9]{13}$","type":"string"},"official_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"normalized_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"english_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"entity_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"entity_type_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"entity_type_label":{"anyOf":[{"type":"string"},{"type":"null"}]},"entity_type_label_en":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string"},{"type":"null"}]},"raw_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"furigana":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"nta":{"additionalProperties":false,"type":"object","required":["available","verified","status","corporate_number","official_name","address","assignment_date","update_date","change_date","close_date","checked_at","source"],"properties":{"available":{"type":"boolean"},"verified":{"type":"boolean"},"status":{"anyOf":[{"type":"string","enum":["verified"]},{"type":"string","enum":["official_directory"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["temporarily_unavailable"]},{"type":"string","enum":["disabled"]}]},"corporate_number":{"pattern":"^[0-9]{13}$","type":"string"},"official_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"assignment_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"update_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"change_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"close_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"checked_at":{"format":"date-time","type":"string"},"source":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"invoice":{"additionalProperties":false,"type":"object","required":["available","registered","valid","status","registration_number","registration_date","cancellation_date","expiration_date","update_date","name","address","checked_at","source"],"properties":{"available":{"type":"boolean"},"registered":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"valid":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["registered"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["expired"]},{"type":"string","enum":["not_registered"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["temporarily_unavailable"]},{"type":"string","enum":["disabled"]}]},"registration_number":{"pattern":"^T[0-9]{13}$","type":"string"},"registration_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"cancellation_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"expiration_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"update_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"checked_at":{"format":"date-time","type":"string"},"source":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"address":{"additionalProperties":false,"type":"object","required":["available","reason","input","normalized","postal_code","prefecture","city","municipality","town","machiaza","lot","sub_number","building","room","normalized_address","source_address","verified_address","verified_level","addressing_system","unresolved_components","latitude","longitude","address_code","resolution"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"input":{"anyOf":[{"type":"string"},{"type":"null"}]},"normalized":{"anyOf":[{"type":"string"},{"type":"null"}]},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"prefecture":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"municipality":{"anyOf":[{"type":"string"},{"type":"null"}]},"town":{"anyOf":[{"type":"string"},{"type":"null"}]},"machiaza":{"anyOf":[{"type":"string"},{"type":"null"}]},"lot":{"anyOf":[{"type":"string"},{"type":"null"}]},"sub_number":{"anyOf":[{"type":"string"},{"type":"null"}]},"building":{"anyOf":[{"type":"string"},{"type":"null"}]},"room":{"anyOf":[{"type":"string"},{"type":"null"}]},"normalized_address":{"anyOf":[{"type":"string"},{"type":"null"}]},"source_address":{"anyOf":[{"type":"string"},{"type":"null"}]},"verified_address":{"anyOf":[{"type":"string"},{"type":"null"}]},"verified_level":{"anyOf":[{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["prefecture"]},{"type":"string","enum":["municipality"]},{"type":"string","enum":["machiaza"]},{"type":"string","enum":["block"]},{"type":"string","enum":["lot"]},{"type":"string","enum":["building"]},{"type":"string","enum":["residential_number"]}]},{"type":"null"}]},"addressing_system":{"anyOf":[{"anyOf":[{"type":"string","enum":["residential_address"]},{"type":"string","enum":["land_lot"]},{"type":"string","enum":["unknown"]}]},{"type":"null"}]},"unresolved_components":{"type":"array","items":{"type":"string"}},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"address_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"resolution":{"additionalProperties":false,"type":"object","required":["match_status","confidence","match_level","coordinate_level","unmatched_text"],"properties":{"match_status":{"anyOf":[{"anyOf":[{"type":"string","enum":["matched"]},{"type":"string","enum":["partial"]},{"type":"string","enum":["ambiguous"]},{"type":"string","enum":["not_found"]}]},{"type":"null"}]},"confidence":{"anyOf":[{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["medium"]},{"type":"string","enum":["low"]}]},{"type":"null"}]},"match_level":{"anyOf":[{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["prefecture"]},{"type":"string","enum":["municipality"]},{"type":"string","enum":["machiaza"]},{"type":"string","enum":["machiaza_detail"]},{"type":"string","enum":["block"]},{"type":"string","enum":["residence"]},{"type":"string","enum":["residential_number"]},{"type":"string","enum":["parcel"]}]},{"type":"null"}]},"coordinate_level":{"anyOf":[{"anyOf":[{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["prefecture"]},{"type":"string","enum":["municipality"]},{"type":"string","enum":["machiaza"]},{"type":"string","enum":["machiaza_detail"]},{"type":"string","enum":["block"]},{"type":"string","enum":["residence"]},{"type":"string","enum":["residential_number"]},{"type":"string","enum":["parcel"]}]},{"type":"string","enum":["unavailable"]}]},{"type":"null"}]},"unmatched_text":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}},"business":{"additionalProperties":false,"type":"object","required":["available","reason","name","normalized_name","name_ja","official_name_en","romanized_name","romanized_name_status","corporate_type","corporate_type_en","corporate_type_position","business_status","industry","business_summary","employee_count","capital_stock","company_url"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"normalized_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"name_ja":{"anyOf":[{"type":"string"},{"type":"null"}]},"official_name_en":{"anyOf":[{"type":"string"},{"type":"null"}]},"romanized_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"romanized_name_status":{"anyOf":[{"type":"string","enum":["official"]},{"type":"string","enum":["generated"]},{"type":"string","enum":["unavailable"]}]},"corporate_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"corporate_type_en":{"anyOf":[{"type":"string"},{"type":"null"}]},"corporate_type_position":{"anyOf":[{"type":"string","enum":["prefix"]},{"type":"string","enum":["suffix"]},{"type":"string","enum":["none"]},{"type":"string","enum":["unknown"]}]},"business_status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["closed"]},{"type":"string","enum":["unknown"]}]},"industry":{"type":"array","items":{"type":"string"}},"business_summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"employee_count":{"anyOf":[{"type":"integer"},{"type":"null"}]},"capital_stock":{"anyOf":[{"type":"number"},{"type":"null"}]},"company_url":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"corporate_group":{"additionalProperties":false,"type":"object","required":["available","reason","group_name","as_of","coverage_note","disclosed_group_company_count","consolidated_subsidiary_count","equity_method_associate_joint_venture_count","members","sources"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"group_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}]},"coverage_note":{"type":"string"},"disclosed_group_company_count":{"minimum":0,"type":"integer"},"consolidated_subsidiary_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}]},"equity_method_associate_joint_venture_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}]},"members":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["name","english_name","relationship_type","established","business_summary","company_url"],"properties":{"name":{"type":"string"},"english_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"relationship_type":{"anyOf":[{"type":"string","enum":["official_group_company"]},{"type":"string","enum":["parent_company"]},{"type":"string","enum":["consolidated_subsidiary"]},{"type":"string","enum":["equity_method_affiliate"]},{"type":"string","enum":["other_related_company"]}]},"established":{"anyOf":[{"type":"string"},{"type":"null"}]},"business_summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"company_url":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"sources":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["title","url","as_of","retrieved_at"],"properties":{"title":{"type":"string"},"url":{"type":"string"},"as_of":{"type":"string"},"retrieved_at":{"format":"date-time","type":"string"}}}}}},"surroundings":{"additionalProperties":false,"type":"object","required":["available","reason","nearest_region","administrative_area","municipality_code","coordinate_level","regional_attributes","stations","facilities"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"nearest_region":{"anyOf":[{"type":"string"},{"type":"null"}]},"administrative_area":{"anyOf":[{"type":"string"},{"type":"null"}]},"municipality_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"coordinate_level":{"anyOf":[{"anyOf":[{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["prefecture"]},{"type":"string","enum":["municipality"]},{"type":"string","enum":["machiaza"]},{"type":"string","enum":["machiaza_detail"]},{"type":"string","enum":["block"]},{"type":"string","enum":["residence"]},{"type":"string","enum":["residential_number"]},{"type":"string","enum":["parcel"]}]},{"type":"string","enum":["unavailable"]}]},{"type":"null"}]},"regional_attributes":{"type":"array","items":{"type":"string"}},"stations":{"type":"array","items":{"type":"string"}},"facilities":{"type":"array","items":{"type":"string"}}}},"market_demographics":{"additionalProperties":false,"type":"object","required":["available","reason","population","households","age_distribution","area_statistics","reference_year","geographic_level","stats_table_ids","unknown_age"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"population":{"anyOf":[{"type":"number"},{"type":"null"}]},"households":{"anyOf":[{"type":"number"},{"type":"null"}]},"age_distribution":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["label","value"],"properties":{"label":{"type":"string"},"value":{"type":"number"}}}},"area_statistics":{"type":"object","additionalProperties":{"type":"number"}},"reference_year":{"anyOf":[{"type":"integer"},{"type":"null"}]},"geographic_level":{"anyOf":[{"type":"string","enum":["municipality"]},{"type":"string","enum":["prefecture"]},{"type":"string","enum":["national"]},{"type":"null"}]},"stats_table_ids":{"type":"object","additionalProperties":{"type":"string"}},"unknown_age":{"anyOf":[{"type":"number"},{"type":"null"}]}}},"property_location":{"additionalProperties":false,"type":"object","required":["available","reason","land_use","zoning","location_attributes","prefecture","municipality","building_coverage_ratio","floor_area_ratio"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"land_use":{"anyOf":[{"type":"string"},{"type":"null"}]},"zoning":{"anyOf":[{"type":"string"},{"type":"null"}]},"location_attributes":{"type":"array","items":{"type":"string"}},"prefecture":{"anyOf":[{"type":"string"},{"type":"null"}]},"municipality":{"anyOf":[{"type":"string"},{"type":"null"}]},"building_coverage_ratio":{"anyOf":[{"type":"number"},{"type":"null"}]},"floor_area_ratio":{"anyOf":[{"type":"number"},{"type":"null"}]}}},"government_public":{"additionalProperties":false,"type":"object","required":["available","reason","subsidies","procurements","certifications","commendations","patents","filings"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"subsidies":{"type":"array","items":{"type":"object","additionalProperties":{}}},"procurements":{"type":"array","items":{"type":"object","additionalProperties":{}}},"certifications":{"type":"array","items":{"type":"object","additionalProperties":{}}},"commendations":{"type":"array","items":{"type":"object","additionalProperties":{}}},"patents":{"type":"array","items":{"type":"object","additionalProperties":{}}},"filings":{"type":"array","items":{"type":"object","additionalProperties":{}}}}},"trust_signals":{"additionalProperties":false,"type":"object","required":["available","reason","corporate_information_verified","public_record_count","certification_count","procurement_count","subsidy_count","filing_count","patent_count","commendation_count","data_freshness","disclaimer"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"corporate_information_verified":{"type":"boolean"},"public_record_count":{"minimum":0,"type":"integer"},"certification_count":{"minimum":0,"type":"integer"},"procurement_count":{"minimum":0,"type":"integer"},"subsidy_count":{"minimum":0,"type":"integer"},"filing_count":{"minimum":0,"type":"integer"},"patent_count":{"minimum":0,"type":"integer"},"commendation_count":{"minimum":0,"type":"integer"},"data_freshness":{"additionalProperties":false,"type":"object","required":["available","reason","value"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"value":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"disclaimer":{"type":"string"}}},"search_aliases":{"additionalProperties":false,"type":"object","required":["available","reason","values"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"values":{"type":"array","items":{"type":"string"}}}},"provenance":{"additionalProperties":false,"type":"object","required":["available","reason","sources"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"sources":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["source","dataset","status","source_type","provider","fields","retrieved_at","last_updated","quality","confidence","fallback_used"],"properties":{"source":{"type":"string"},"dataset":{"type":"string"},"status":{"type":"string"},"source_type":{"anyOf":[{"type":"string","enum":["government_api"]},{"type":"string","enum":["government_open_data"]},{"type":"string","enum":["government_statistics"]},{"type":"string","enum":["japan_api_store"]},{"type":"string","enum":["official_company_disclosure"]}]},"provider":{"type":"string"},"fields":{"type":"array","items":{"type":"string"}},"retrieved_at":{"format":"date-time","type":"string"},"last_updated":{"anyOf":[{"type":"string"},{"type":"null"}]},"quality":{"anyOf":[{"type":"string","enum":["official"]},{"type":"string","enum":["derived"]},{"type":"string","enum":["unavailable"]}]},"confidence":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["medium"]},{"type":"string","enum":["low"]}]},"fallback_used":{"type":"boolean"}}}}}},"query":{"additionalProperties":false,"type":"object","required":["input","normalized","detected_type"],"properties":{"input":{"type":"string"},"normalized":{"type":"string"},"detected_type":{"anyOf":[{"type":"string","enum":["company_name"]},{"type":"string","enum":["corporate_number"]},{"type":"string","enum":["address"]}]}}},"match":{"additionalProperties":false,"type":"object","required":["status","confidence"],"properties":{"status":{"anyOf":[{"type":"string","enum":["matched"]},{"type":"string","enum":["partial"]},{"type":"string","enum":["not_found"]}]},"confidence":{"anyOf":[{"type":"string","enum":["exact"]},{"type":"string","enum":["high"]},{"type":"string","enum":["medium"]},{"type":"string","enum":["low"]},{"type":"string","enum":["unresolved"]}]}}},"corporate":{"additionalProperties":false,"type":"object","required":["available","reason","corporate_number","corporate_number_status","registration_status"],"properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"anyOf":[{"type":"string","enum":["data_not_found"]},{"type":"string","enum":["provider_not_connected"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["provider_error"]},{"type":"string","enum":["not_applicable"]}]},{"type":"null"}]},"corporate_number":{"anyOf":[{"pattern":"^[0-9]{13}$","type":"string"},{"type":"null"}]},"corporate_number_status":{"anyOf":[{"type":"string","enum":["verified"]},{"type":"string","enum":["provider_pending"]},{"type":"string","enum":["not_found"]}]},"registration_status":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"location":{"additionalProperties":false,"type":"object","required":["available","latitude","longitude","coordinate_level","coordinate_source"],"properties":{"available":{"type":"boolean"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"coordinate_level":{"anyOf":[{"anyOf":[{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["prefecture"]},{"type":"string","enum":["municipality"]},{"type":"string","enum":["machiaza"]},{"type":"string","enum":["machiaza_detail"]},{"type":"string","enum":["block"]},{"type":"string","enum":["residence"]},{"type":"string","enum":["residential_number"]},{"type":"string","enum":["parcel"]}]},{"type":"string","enum":["unavailable"]}]},{"type":"null"}]},"coordinate_source":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"industry":{"additionalProperties":false,"type":"object","required":["available","classifications","summary"],"properties":{"available":{"type":"boolean"},"classifications":{"type":"array","items":{"type":"string"}},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"registrations":{"additionalProperties":false,"type":"object","required":["available","certifications","commendations","procurements","subsidies","patents"],"properties":{"available":{"type":"boolean"},"certifications":{"type":"array","items":{"type":"object","additionalProperties":{}}},"commendations":{"type":"array","items":{"type":"object","additionalProperties":{}}},"procurements":{"type":"array","items":{"type":"object","additionalProperties":{}}},"subsidies":{"type":"array","items":{"type":"object","additionalProperties":{}}},"patents":{"type":"array","items":{"type":"object","additionalProperties":{}}}}},"financial":{"additionalProperties":false,"type":"object","required":["available","edinet_code","securities_code","filing_available","latest_filing","fiscal_period"],"properties":{"available":{"type":"boolean"},"edinet_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"securities_code":{"type":"null"},"filing_available":{"type":"boolean"},"latest_filing":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"fiscal_period":{"additionalProperties":false,"type":"object","required":["start","end"],"properties":{"start":{"anyOf":[{"type":"string"},{"type":"null"}]},"end":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}},"real_estate":{"additionalProperties":false,"type":"object","required":["scope","available","land_use","zoning","ownership_inferred"],"properties":{"scope":{"type":"string","enum":["address_area"]},"available":{"type":"boolean"},"land_use":{"anyOf":[{"type":"string"},{"type":"null"}]},"zoning":{"anyOf":[{"type":"string"},{"type":"null"}]},"ownership_inferred":{"type":"boolean","enum":[false]}}},"sources":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["source","dataset","status","source_type","provider","fields","retrieved_at","last_updated","quality","confidence","fallback_used"],"properties":{"source":{"type":"string"},"dataset":{"type":"string"},"status":{"type":"string"},"source_type":{"anyOf":[{"type":"string","enum":["government_api"]},{"type":"string","enum":["government_open_data"]},{"type":"string","enum":["government_statistics"]},{"type":"string","enum":["japan_api_store"]},{"type":"string","enum":["official_company_disclosure"]}]},"provider":{"type":"string"},"fields":{"type":"array","items":{"type":"string"}},"retrieved_at":{"format":"date-time","type":"string"},"last_updated":{"anyOf":[{"type":"string"},{"type":"null"}]},"quality":{"anyOf":[{"type":"string","enum":["official"]},{"type":"string","enum":["derived"]},{"type":"string","enum":["unavailable"]}]},"confidence":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["medium"]},{"type":"string","enum":["low"]}]},"fallback_used":{"type":"boolean"}}}},"warnings":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["provider","reason","message"],"properties":{"provider":{"type":"string"},"reason":{"type":"string"},"message":{"type":"string"}}}},"data_freshness":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"null"}]}},"providers":{"additionalProperties":false,"type":"object","required":["nta","gbizinfo","estat","edinet","mlit_reinfolib","address_mix"],"properties":{"nta":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["connected"]},{"type":"string","enum":["error"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["timeout"]},{"type":"string","enum":["disabled"]}]},"gbizinfo":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["connected"]},{"type":"string","enum":["error"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["timeout"]},{"type":"string","enum":["disabled"]}]},"estat":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["connected"]},{"type":"string","enum":["error"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["timeout"]},{"type":"string","enum":["disabled"]}]},"edinet":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["connected"]},{"type":"string","enum":["error"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["timeout"]},{"type":"string","enum":["disabled"]}]},"mlit_reinfolib":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["connected"]},{"type":"string","enum":["error"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["timeout"]},{"type":"string","enum":["disabled"]}]},"address_mix":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["connected"]},{"type":"string","enum":["error"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["timeout"]},{"type":"string","enum":["disabled"]}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}}}}},"/v1/sellability/demo":{"post":{"summary":"Run a rate-limited anonymous Japan Sellability assessment","description":"Registration-free product assessment isolated from API-key usage and the formal API route.","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["product_name","category"],"properties":{"product_name":{"minLength":1,"maxLength":160,"type":"string"},"category":{"anyOf":[{"type":"string","enum":["Food"]},{"type":"string","enum":["Beverage"]},{"type":"string","enum":["Supplement"]},{"type":"string","enum":["Cosmetics"]},{"type":"string","enum":["Pharmaceutical"]},{"type":"string","enum":["Quasi-drug"]},{"type":"string","enum":["Medical Device"]},{"type":"string","enum":["Electrical Appliance"]},{"type":"string","enum":["Electronics"]},{"type":"string","enum":["Battery"]},{"type":"string","enum":["Toy"]},{"type":"string","enum":["Baby Product"]},{"type":"string","enum":["Clothing"]},{"type":"string","enum":["Textile"]},{"type":"string","enum":["Chemical"]},{"type":"string","enum":["Detergent"]},{"type":"string","enum":["Household Product"]},{"type":"string","enum":["Furniture"]},{"type":"string","enum":["Kitchenware"]},{"type":"string","enum":["Container / Packaging"]},{"type":"string","enum":["Agricultural Product"]},{"type":"string","enum":["Plant"]},{"type":"string","enum":["Animal Product"]},{"type":"string","enum":["Pet Product"]},{"type":"string","enum":["Pet Food"]},{"type":"string","enum":["Alcohol"]},{"type":"string","enum":["Tobacco / Nicotine"]},{"type":"string","enum":["Vehicle / Parts"]},{"type":"string","enum":["Machinery"]},{"type":"string","enum":["Radio Equipment"]},{"type":"string","enum":["Luxury Goods"]},{"type":"string","enum":["Wildlife Product"]},{"type":"string","enum":["General Goods"]},{"type":"string","enum":["Unknown"]}]},"description":{"minLength":1,"maxLength":1000,"type":"string"},"intended_use":{"minLength":1,"maxLength":500,"type":"string"},"materials":{"maxItems":16,"type":"array","items":{"minLength":1,"maxLength":120,"type":"string"}},"uses_power":{"type":"boolean"},"wireless_function":{"type":"boolean"},"food_contact":{"type":"boolean"},"chemicals_or_ingredients":{"maxItems":32,"type":"array","items":{"minLength":1,"maxLength":160,"type":"string"}},"medical_purpose":{"type":"boolean"},"target_age":{"anyOf":[{"minimum":0,"maximum":150,"type":"number"},{"minLength":1,"maxLength":60,"type":"string"}]},"origin_country":{"minLength":2,"maxLength":80,"type":"string"},"hs_code":{"minLength":4,"maxLength":16,"pattern":"^[0-9. -]+$","type":"string"},"notes":{"minLength":1,"maxLength":1000,"type":"string"},"follow_up_answers":{"maxItems":24,"type":"array","items":{"additionalProperties":false,"type":"object","required":["field","answer"],"properties":{"field":{"anyOf":[{"type":"string","enum":["intended_use"]},{"type":"string","enum":["origin_country"]},{"type":"string","enum":["materials"]},{"type":"string","enum":["ingredients"]},{"type":"string","enum":["food_contact"]},{"type":"string","enum":["medical_purpose"]},{"type":"string","enum":["target_age"]},{"type":"string","enum":["uses_power"]},{"type":"string","enum":["wireless_function"]},{"type":"string","enum":["rated_voltage"]},{"type":"string","enum":["technical_conformity_number"]},{"type":"string","enum":["approval_or_certification_number"]},{"type":"string","enum":["certification"]},{"type":"string","enum":["cas_numbers"]},{"type":"string","enum":["official_scope_evidence"]},{"type":"string","enum":["exact_official_identifier"]},{"type":"string","enum":["hs_code"]},{"type":"string","enum":["frequency_bands"]},{"type":"string","enum":["radio_frequency"]},{"type":"string","enum":["radio_protocols"]},{"type":"string","enum":["transmit_power"]},{"type":"string","enum":["magnet_specification"]},{"type":"string","enum":["scientific_name"]},{"type":"string","enum":["origin_region"]},{"type":"string","enum":["export_country"]},{"type":"string","enum":["product_form"]},{"type":"string","enum":["product_part"]},{"type":"string","enum":["plant_part"]},{"type":"string","enum":["animal_part"]},{"type":"string","enum":["processing_state"]},{"type":"string","enum":["processing_method"]},{"type":"string","enum":["packaging"]},{"type":"string","enum":["prior_use"]},{"type":"string","enum":["government_certificate"]},{"type":"string","enum":["species"]},{"type":"string","enum":["intended_species"]},{"type":"string","enum":["target_species"]},{"type":"string","enum":["importer_role"]},{"type":"string","enum":["business_role"]},{"type":"string","enum":["fertilizer_registration_number"]},{"type":"string","enum":["official_registration_scope"]},{"type":"string","enum":["import_purpose"]},{"type":"string","enum":["annual_quantity_kg"]},{"type":"string","enum":["heat_temperature_c"]},{"type":"string","enum":["heat_duration_seconds"]},{"type":"string","enum":["designated_facility_confirmed"]},{"type":"string","enum":["health_certificate_confirmed"]},{"type":"string","enum":["import_prohibited"]},{"type":"string","enum":["matches_certificate_required_rule"]},{"type":"string","enum":["frozen_solid"]},{"type":"string","enum":["frozen_temperature_c"]},{"type":"string","enum":["agricultural_production_use"]},{"type":"string","enum":["all_risk_criteria_confirmed"]},{"type":"string","enum":["legal_notes_confirmed"]}]},"answer":{"minLength":1,"maxLength":500,"type":"string"}}}},"example_id":{"anyOf":[{"type":"string","enum":["bluetooth_speaker"]},{"type":"string","enum":["ac_adapter"]},{"type":"string","enum":["children_toy"]},{"type":"string","enum":["plain_notebook"]},{"type":"string","enum":["dark_chocolate"]}]}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","status","reason","guidance","confidence","normalized_product","missing_information","requirements","restrictions","rules_checked","authorities_checked","official_sources","additional_checks","data_freshness","usage","disclaimer"],"properties":{"request_id":{"pattern":"^req_[a-f0-9]{32}$","type":"string"},"success":{"type":"boolean","enum":[true]},"status":{"anyOf":[{"type":"string","enum":["SELLABLE"]},{"type":"string","enum":["SELLABLE_WITH_CONDITIONS"]},{"type":"string","enum":["REVIEW_REQUIRED"]},{"type":"string","enum":["NOT_SELLABLE"]}]},"decision":{"anyOf":[{"type":"string","enum":["SELLABLE"]},{"type":"string","enum":["SELLABLE_WITH_CONDITIONS"]},{"type":"string","enum":["REVIEW_REQUIRED"]},{"type":"string","enum":["NOT_SELLABLE"]}]},"reason":{"type":"string"},"guidance":{"type":"string"},"confidence":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["medium"]},{"type":"string","enum":["low"]}]},"confidence_score":{"minimum":0,"maximum":100,"type":"integer"},"confidence_method":{"type":"string","enum":["deterministic_weighted_rules_v1"]},"provisional":{"type":"boolean"},"summary":{"type":"string"},"normalized_product":{"additionalProperties":false,"type":"object","required":["product_name","category","intended_use","origin_country","destination_country"],"properties":{"product_name":{"type":"string"},"category":{"anyOf":[{"type":"string","enum":["Food"]},{"type":"string","enum":["Beverage"]},{"type":"string","enum":["Supplement"]},{"type":"string","enum":["Cosmetics"]},{"type":"string","enum":["Pharmaceutical"]},{"type":"string","enum":["Quasi-drug"]},{"type":"string","enum":["Medical Device"]},{"type":"string","enum":["Electrical Appliance"]},{"type":"string","enum":["Electronics"]},{"type":"string","enum":["Battery"]},{"type":"string","enum":["Toy"]},{"type":"string","enum":["Baby Product"]},{"type":"string","enum":["Clothing"]},{"type":"string","enum":["Textile"]},{"type":"string","enum":["Chemical"]},{"type":"string","enum":["Detergent"]},{"type":"string","enum":["Household Product"]},{"type":"string","enum":["Furniture"]},{"type":"string","enum":["Kitchenware"]},{"type":"string","enum":["Container / Packaging"]},{"type":"string","enum":["Agricultural Product"]},{"type":"string","enum":["Plant"]},{"type":"string","enum":["Animal Product"]},{"type":"string","enum":["Pet Product"]},{"type":"string","enum":["Pet Food"]},{"type":"string","enum":["Alcohol"]},{"type":"string","enum":["Tobacco / Nicotine"]},{"type":"string","enum":["Vehicle / Parts"]},{"type":"string","enum":["Machinery"]},{"type":"string","enum":["Radio Equipment"]},{"type":"string","enum":["Luxury Goods"]},{"type":"string","enum":["Wildlife Product"]},{"type":"string","enum":["General Goods"]},{"type":"string","enum":["Unknown"]}]},"intended_use":{"anyOf":[{"type":"string"},{"type":"null"}]},"origin_country":{"anyOf":[{"type":"string"},{"type":"null"}]},"hs_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"destination_country":{"type":"string","enum":["JP"]}}},"missing_information":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["field","label","question"],"properties":{"field":{"type":"string"},"label":{"type":"string"},"question":{"type":"string"},"priority":{"anyOf":[{"type":"string","enum":["CRITICAL"]},{"type":"string","enum":["HIGH"]},{"type":"string","enum":["MEDIUM"]},{"type":"string","enum":["LOW"]}]},"reason":{"type":"string"}}}},"requirements":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["type","name","authority","rule_id"],"properties":{"type":{"type":"string"},"name":{"type":"string"},"authority":{"type":"string"},"rule_id":{"type":"string"}}}},"restrictions":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["name","authority","rule_id"],"properties":{"name":{"type":"string"},"authority":{"type":"string"},"rule_id":{"type":"string"}}}},"rules_checked":{"type":"array","items":{"type":"string"}},"authorities_checked":{"type":"array","items":{"type":"string"}},"official_sources":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["source_id","source_name","organization","official_url","version","last_checked_at","retrieved_at","effective_from","update_frequency","status","fallback_used"],"properties":{"source_id":{"type":"string"},"source_name":{"type":"string"},"organization":{"type":"string"},"official_url":{"format":"uri","type":"string"},"version":{"anyOf":[{"type":"string"},{"type":"null"}]},"last_checked_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"retrieved_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"effective_from":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"update_frequency":{"type":"string"},"status":{"type":"string"},"fallback_used":{"type":"boolean"}}}},"additional_checks":{"type":"array","items":{"type":"string"}},"data_freshness":{"additionalProperties":false,"type":"object","required":["engine","phase4_version","regulatory_version","customs_version","assessed_at"],"properties":{"engine":{"type":"string","enum":["phase4"]},"phase4_version":{"type":"string"},"regulatory_version":{"type":"string"},"customs_version":{"type":"string"},"assessed_at":{"format":"date-time","type":"string"}}},"usage":{"additionalProperties":false,"type":"object","required":["counted","channel"],"properties":{"counted":{"type":"boolean"},"channel":{"anyOf":[{"type":"string","enum":["anonymous_demo"]},{"type":"string","enum":["api_key"]}]}}},"disclaimer":{"type":"string"}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}}}}},"/v1/sellability/check":{"post":{"summary":"Assess whether a product can proceed toward sale in Japan","description":"Conservative, source-backed assessment using verified Japanese public data. Unresolved facts remain explicit and never become an unsupported approval.","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["product_name","category"],"properties":{"product_name":{"minLength":1,"maxLength":160,"type":"string"},"category":{"anyOf":[{"type":"string","enum":["Food"]},{"type":"string","enum":["Beverage"]},{"type":"string","enum":["Supplement"]},{"type":"string","enum":["Cosmetics"]},{"type":"string","enum":["Pharmaceutical"]},{"type":"string","enum":["Quasi-drug"]},{"type":"string","enum":["Medical Device"]},{"type":"string","enum":["Electrical Appliance"]},{"type":"string","enum":["Electronics"]},{"type":"string","enum":["Battery"]},{"type":"string","enum":["Toy"]},{"type":"string","enum":["Baby Product"]},{"type":"string","enum":["Clothing"]},{"type":"string","enum":["Textile"]},{"type":"string","enum":["Chemical"]},{"type":"string","enum":["Detergent"]},{"type":"string","enum":["Household Product"]},{"type":"string","enum":["Furniture"]},{"type":"string","enum":["Kitchenware"]},{"type":"string","enum":["Container / Packaging"]},{"type":"string","enum":["Agricultural Product"]},{"type":"string","enum":["Plant"]},{"type":"string","enum":["Animal Product"]},{"type":"string","enum":["Pet Product"]},{"type":"string","enum":["Pet Food"]},{"type":"string","enum":["Alcohol"]},{"type":"string","enum":["Tobacco / Nicotine"]},{"type":"string","enum":["Vehicle / Parts"]},{"type":"string","enum":["Machinery"]},{"type":"string","enum":["Radio Equipment"]},{"type":"string","enum":["Luxury Goods"]},{"type":"string","enum":["Wildlife Product"]},{"type":"string","enum":["General Goods"]},{"type":"string","enum":["Unknown"]}]},"description":{"minLength":1,"maxLength":1000,"type":"string"},"intended_use":{"minLength":1,"maxLength":500,"type":"string"},"materials":{"maxItems":16,"type":"array","items":{"minLength":1,"maxLength":120,"type":"string"}},"uses_power":{"type":"boolean"},"wireless_function":{"type":"boolean"},"food_contact":{"type":"boolean"},"chemicals_or_ingredients":{"maxItems":32,"type":"array","items":{"minLength":1,"maxLength":160,"type":"string"}},"medical_purpose":{"type":"boolean"},"target_age":{"anyOf":[{"minimum":0,"maximum":150,"type":"number"},{"minLength":1,"maxLength":60,"type":"string"}]},"origin_country":{"minLength":2,"maxLength":80,"type":"string"},"hs_code":{"minLength":4,"maxLength":16,"pattern":"^[0-9. -]+$","type":"string"},"notes":{"minLength":1,"maxLength":1000,"type":"string"},"follow_up_answers":{"maxItems":24,"type":"array","items":{"additionalProperties":false,"type":"object","required":["field","answer"],"properties":{"field":{"anyOf":[{"type":"string","enum":["intended_use"]},{"type":"string","enum":["origin_country"]},{"type":"string","enum":["materials"]},{"type":"string","enum":["ingredients"]},{"type":"string","enum":["food_contact"]},{"type":"string","enum":["medical_purpose"]},{"type":"string","enum":["target_age"]},{"type":"string","enum":["uses_power"]},{"type":"string","enum":["wireless_function"]},{"type":"string","enum":["rated_voltage"]},{"type":"string","enum":["technical_conformity_number"]},{"type":"string","enum":["approval_or_certification_number"]},{"type":"string","enum":["certification"]},{"type":"string","enum":["cas_numbers"]},{"type":"string","enum":["official_scope_evidence"]},{"type":"string","enum":["exact_official_identifier"]},{"type":"string","enum":["hs_code"]},{"type":"string","enum":["frequency_bands"]},{"type":"string","enum":["radio_frequency"]},{"type":"string","enum":["radio_protocols"]},{"type":"string","enum":["transmit_power"]},{"type":"string","enum":["magnet_specification"]},{"type":"string","enum":["scientific_name"]},{"type":"string","enum":["origin_region"]},{"type":"string","enum":["export_country"]},{"type":"string","enum":["product_form"]},{"type":"string","enum":["product_part"]},{"type":"string","enum":["plant_part"]},{"type":"string","enum":["animal_part"]},{"type":"string","enum":["processing_state"]},{"type":"string","enum":["processing_method"]},{"type":"string","enum":["packaging"]},{"type":"string","enum":["prior_use"]},{"type":"string","enum":["government_certificate"]},{"type":"string","enum":["species"]},{"type":"string","enum":["intended_species"]},{"type":"string","enum":["target_species"]},{"type":"string","enum":["importer_role"]},{"type":"string","enum":["business_role"]},{"type":"string","enum":["fertilizer_registration_number"]},{"type":"string","enum":["official_registration_scope"]},{"type":"string","enum":["import_purpose"]},{"type":"string","enum":["annual_quantity_kg"]},{"type":"string","enum":["heat_temperature_c"]},{"type":"string","enum":["heat_duration_seconds"]},{"type":"string","enum":["designated_facility_confirmed"]},{"type":"string","enum":["health_certificate_confirmed"]},{"type":"string","enum":["import_prohibited"]},{"type":"string","enum":["matches_certificate_required_rule"]},{"type":"string","enum":["frozen_solid"]},{"type":"string","enum":["frozen_temperature_c"]},{"type":"string","enum":["agricultural_production_use"]},{"type":"string","enum":["all_risk_criteria_confirmed"]},{"type":"string","enum":["legal_notes_confirmed"]}]},"answer":{"minLength":1,"maxLength":500,"type":"string"}}}}}}}}},"security":[{"bearerApiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","status","reason","guidance","confidence","normalized_product","missing_information","requirements","restrictions","rules_checked","authorities_checked","official_sources","additional_checks","data_freshness","usage","disclaimer"],"properties":{"request_id":{"pattern":"^req_[a-f0-9]{32}$","type":"string"},"success":{"type":"boolean","enum":[true]},"status":{"anyOf":[{"type":"string","enum":["SELLABLE"]},{"type":"string","enum":["SELLABLE_WITH_CONDITIONS"]},{"type":"string","enum":["REVIEW_REQUIRED"]},{"type":"string","enum":["NOT_SELLABLE"]}]},"decision":{"anyOf":[{"type":"string","enum":["SELLABLE"]},{"type":"string","enum":["SELLABLE_WITH_CONDITIONS"]},{"type":"string","enum":["REVIEW_REQUIRED"]},{"type":"string","enum":["NOT_SELLABLE"]}]},"reason":{"type":"string"},"guidance":{"type":"string"},"confidence":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["medium"]},{"type":"string","enum":["low"]}]},"confidence_score":{"minimum":0,"maximum":100,"type":"integer"},"confidence_method":{"type":"string","enum":["deterministic_weighted_rules_v1"]},"provisional":{"type":"boolean"},"summary":{"type":"string"},"normalized_product":{"additionalProperties":false,"type":"object","required":["product_name","category","intended_use","origin_country","destination_country"],"properties":{"product_name":{"type":"string"},"category":{"anyOf":[{"type":"string","enum":["Food"]},{"type":"string","enum":["Beverage"]},{"type":"string","enum":["Supplement"]},{"type":"string","enum":["Cosmetics"]},{"type":"string","enum":["Pharmaceutical"]},{"type":"string","enum":["Quasi-drug"]},{"type":"string","enum":["Medical Device"]},{"type":"string","enum":["Electrical Appliance"]},{"type":"string","enum":["Electronics"]},{"type":"string","enum":["Battery"]},{"type":"string","enum":["Toy"]},{"type":"string","enum":["Baby Product"]},{"type":"string","enum":["Clothing"]},{"type":"string","enum":["Textile"]},{"type":"string","enum":["Chemical"]},{"type":"string","enum":["Detergent"]},{"type":"string","enum":["Household Product"]},{"type":"string","enum":["Furniture"]},{"type":"string","enum":["Kitchenware"]},{"type":"string","enum":["Container / Packaging"]},{"type":"string","enum":["Agricultural Product"]},{"type":"string","enum":["Plant"]},{"type":"string","enum":["Animal Product"]},{"type":"string","enum":["Pet Product"]},{"type":"string","enum":["Pet Food"]},{"type":"string","enum":["Alcohol"]},{"type":"string","enum":["Tobacco / Nicotine"]},{"type":"string","enum":["Vehicle / Parts"]},{"type":"string","enum":["Machinery"]},{"type":"string","enum":["Radio Equipment"]},{"type":"string","enum":["Luxury Goods"]},{"type":"string","enum":["Wildlife Product"]},{"type":"string","enum":["General Goods"]},{"type":"string","enum":["Unknown"]}]},"intended_use":{"anyOf":[{"type":"string"},{"type":"null"}]},"origin_country":{"anyOf":[{"type":"string"},{"type":"null"}]},"hs_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"destination_country":{"type":"string","enum":["JP"]}}},"missing_information":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["field","label","question"],"properties":{"field":{"type":"string"},"label":{"type":"string"},"question":{"type":"string"},"priority":{"anyOf":[{"type":"string","enum":["CRITICAL"]},{"type":"string","enum":["HIGH"]},{"type":"string","enum":["MEDIUM"]},{"type":"string","enum":["LOW"]}]},"reason":{"type":"string"}}}},"requirements":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["type","name","authority","rule_id"],"properties":{"type":{"type":"string"},"name":{"type":"string"},"authority":{"type":"string"},"rule_id":{"type":"string"}}}},"restrictions":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["name","authority","rule_id"],"properties":{"name":{"type":"string"},"authority":{"type":"string"},"rule_id":{"type":"string"}}}},"rules_checked":{"type":"array","items":{"type":"string"}},"authorities_checked":{"type":"array","items":{"type":"string"}},"official_sources":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["source_id","source_name","organization","official_url","version","last_checked_at","retrieved_at","effective_from","update_frequency","status","fallback_used"],"properties":{"source_id":{"type":"string"},"source_name":{"type":"string"},"organization":{"type":"string"},"official_url":{"format":"uri","type":"string"},"version":{"anyOf":[{"type":"string"},{"type":"null"}]},"last_checked_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"retrieved_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"effective_from":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"update_frequency":{"type":"string"},"status":{"type":"string"},"fallback_used":{"type":"boolean"}}}},"additional_checks":{"type":"array","items":{"type":"string"}},"data_freshness":{"additionalProperties":false,"type":"object","required":["engine","phase4_version","regulatory_version","customs_version","assessed_at"],"properties":{"engine":{"type":"string","enum":["phase4"]},"phase4_version":{"type":"string"},"regulatory_version":{"type":"string"},"customs_version":{"type":"string"},"assessed_at":{"format":"date-time","type":"string"}}},"usage":{"additionalProperties":false,"type":"object","required":["counted","channel"],"properties":{"counted":{"type":"boolean"},"channel":{"anyOf":[{"type":"string","enum":["anonymous_demo"]},{"type":"string","enum":["api_key"]}]}}},"disclaimer":{"type":"string"}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}}}}},"/v1/profitability/calculate":{"post":{"summary":"Estimate the unit economics of selling an imported product in Japan","description":"Deterministic JPY cost, duty, import-tax, logistics, channel-fee, break-even, margin, confidence, and market-entry calculation with explicit assumptions.","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"anyOf":[{"required":["product_name"]},{"required":["sellability_response"]}],"type":"object","required":["cost"],"properties":{"product_name":{"minLength":1,"maxLength":160,"type":"string"},"category":{"anyOf":[{"type":"string","enum":["Food"]},{"type":"string","enum":["Beverage"]},{"type":"string","enum":["Supplement"]},{"type":"string","enum":["Cosmetics"]},{"type":"string","enum":["Pharmaceutical"]},{"type":"string","enum":["Quasi-drug"]},{"type":"string","enum":["Medical Device"]},{"type":"string","enum":["Electrical Appliance"]},{"type":"string","enum":["Electronics"]},{"type":"string","enum":["Battery"]},{"type":"string","enum":["Toy"]},{"type":"string","enum":["Baby Product"]},{"type":"string","enum":["Clothing"]},{"type":"string","enum":["Textile"]},{"type":"string","enum":["Chemical"]},{"type":"string","enum":["Detergent"]},{"type":"string","enum":["Household Product"]},{"type":"string","enum":["Furniture"]},{"type":"string","enum":["Kitchenware"]},{"type":"string","enum":["Container / Packaging"]},{"type":"string","enum":["Agricultural Product"]},{"type":"string","enum":["Plant"]},{"type":"string","enum":["Animal Product"]},{"type":"string","enum":["Pet Product"]},{"type":"string","enum":["Pet Food"]},{"type":"string","enum":["Alcohol"]},{"type":"string","enum":["Tobacco / Nicotine"]},{"type":"string","enum":["Vehicle / Parts"]},{"type":"string","enum":["Machinery"]},{"type":"string","enum":["Radio Equipment"]},{"type":"string","enum":["Luxury Goods"]},{"type":"string","enum":["Wildlife Product"]},{"type":"string","enum":["General Goods"]},{"type":"string","enum":["Unknown"]}]},"origin_country":{"minLength":2,"maxLength":80,"type":"string"},"hs_code":{"minLength":4,"maxLength":16,"pattern":"^[0-9. -]+$","type":"string"},"target_market":{"type":"string","enum":["JP"]},"cost":{"additionalProperties":false,"type":"object","required":["amount","currency"],"properties":{"amount":{"minimum":0,"maximum":1000000000,"type":"number"},"currency":{"minLength":3,"maxLength":3,"pattern":"^[A-Za-z]{3}$","type":"string"}}},"selling_price":{"additionalProperties":false,"type":"object","required":["amount","currency"],"properties":{"amount":{"minimum":0,"maximum":1000000000,"type":"number"},"currency":{"minLength":3,"maxLength":3,"pattern":"^[A-Za-z]{3}$","type":"string"}}},"channel":{"anyOf":[{"type":"string","enum":["amazon_jp"]},{"type":"string","enum":["rakuten"]},{"type":"string","enum":["yahoo_japan"]},{"type":"string","enum":["own_ec"]}]},"international_shipping":{"additionalProperties":false,"type":"object","required":["amount","currency"],"properties":{"amount":{"minimum":0,"maximum":1000000000,"type":"number"},"currency":{"minLength":3,"maxLength":3,"pattern":"^[A-Za-z]{3}$","type":"string"},"source":{"anyOf":[{"type":"string","enum":["official"]},{"type":"string","enum":["provided"]},{"type":"string","enum":["estimated"]},{"type":"string","enum":["default"]}]}}},"insurance":{"additionalProperties":false,"type":"object","required":["amount","currency"],"properties":{"amount":{"minimum":0,"maximum":1000000000,"type":"number"},"currency":{"minLength":3,"maxLength":3,"pattern":"^[A-Za-z]{3}$","type":"string"},"source":{"anyOf":[{"type":"string","enum":["official"]},{"type":"string","enum":["provided"]},{"type":"string","enum":["estimated"]},{"type":"string","enum":["default"]}]}}},"customs_clearance":{"additionalProperties":false,"type":"object","required":["amount","currency"],"properties":{"amount":{"minimum":0,"maximum":1000000000,"type":"number"},"currency":{"minLength":3,"maxLength":3,"pattern":"^[A-Za-z]{3}$","type":"string"},"source":{"anyOf":[{"type":"string","enum":["official"]},{"type":"string","enum":["provided"]},{"type":"string","enum":["estimated"]},{"type":"string","enum":["default"]}]}}},"domestic_logistics":{"additionalProperties":false,"type":"object","required":["amount","currency"],"properties":{"amount":{"minimum":0,"maximum":1000000000,"type":"number"},"currency":{"minLength":3,"maxLength":3,"pattern":"^[A-Za-z]{3}$","type":"string"},"source":{"anyOf":[{"type":"string","enum":["official"]},{"type":"string","enum":["provided"]},{"type":"string","enum":["estimated"]},{"type":"string","enum":["default"]}]}}},"other_costs":{"maxItems":20,"type":"array","items":{"additionalProperties":false,"type":"object","required":["name","amount","currency"],"properties":{"name":{"minLength":1,"maxLength":80,"type":"string"},"amount":{"minimum":0,"maximum":1000000000,"type":"number"},"currency":{"minLength":3,"maxLength":3,"pattern":"^[A-Za-z]{3}$","type":"string"},"source":{"anyOf":[{"type":"string","enum":["official"]},{"type":"string","enum":["provided"]},{"type":"string","enum":["estimated"]},{"type":"string","enum":["default"]}]}}}},"exchange_rates":{"maxItems":40,"type":"array","items":{"additionalProperties":false,"type":"object","required":["currency","jpy_per_unit"],"properties":{"currency":{"minLength":3,"maxLength":3,"pattern":"^[A-Za-z]{3}$","type":"string"},"jpy_per_unit":{"exclusiveMinimum":0,"maximum":1000000,"type":"number"},"as_of":{"format":"date","type":"string"},"source":{"anyOf":[{"type":"string","enum":["official"]},{"type":"string","enum":["provided"]},{"type":"string","enum":["estimated"]},{"type":"string","enum":["default"]}]}}}},"customs":{"additionalProperties":false,"type":"object","properties":{"duty_rate_percent":{"minimum":0,"maximum":1000,"type":"number"},"import_tax_rate_percent":{"anyOf":[{"type":"number","enum":[8]},{"type":"number","enum":[10]}]},"preferential_origin_qualified":{"type":"boolean"}}},"fees":{"additionalProperties":false,"type":"object","properties":{"platform_fee_percent":{"minimum":0,"maximum":100,"type":"number"},"payment_fee_percent":{"minimum":0,"maximum":100,"type":"number"},"fixed_fee_jpy":{"minimum":0,"maximum":1000000,"type":"number"}}},"assumptions":{"additionalProperties":false,"type":"object","properties":{"monthly_orders":{"minimum":1,"maximum":10000000,"type":"integer"},"target_margin_percent":{"minimum":0,"maximum":80,"type":"number"},"calculation_date":{"format":"date","type":"string"}}},"sellability_response":{"additionalProperties":false,"type":"object","required":["request_id","success","status","reason","guidance","confidence","normalized_product","missing_information","requirements","restrictions","rules_checked","authorities_checked","official_sources","additional_checks","data_freshness","usage","disclaimer"],"properties":{"request_id":{"pattern":"^req_[a-f0-9]{32}$","type":"string"},"success":{"type":"boolean","enum":[true]},"status":{"anyOf":[{"type":"string","enum":["SELLABLE"]},{"type":"string","enum":["SELLABLE_WITH_CONDITIONS"]},{"type":"string","enum":["REVIEW_REQUIRED"]},{"type":"string","enum":["NOT_SELLABLE"]}]},"decision":{"anyOf":[{"type":"string","enum":["SELLABLE"]},{"type":"string","enum":["SELLABLE_WITH_CONDITIONS"]},{"type":"string","enum":["REVIEW_REQUIRED"]},{"type":"string","enum":["NOT_SELLABLE"]}]},"reason":{"type":"string"},"guidance":{"type":"string"},"confidence":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["medium"]},{"type":"string","enum":["low"]}]},"confidence_score":{"minimum":0,"maximum":100,"type":"integer"},"confidence_method":{"type":"string","enum":["deterministic_weighted_rules_v1"]},"provisional":{"type":"boolean"},"summary":{"type":"string"},"normalized_product":{"additionalProperties":false,"type":"object","required":["product_name","category","intended_use","origin_country","destination_country"],"properties":{"product_name":{"type":"string"},"category":{"anyOf":[{"type":"string","enum":["Food"]},{"type":"string","enum":["Beverage"]},{"type":"string","enum":["Supplement"]},{"type":"string","enum":["Cosmetics"]},{"type":"string","enum":["Pharmaceutical"]},{"type":"string","enum":["Quasi-drug"]},{"type":"string","enum":["Medical Device"]},{"type":"string","enum":["Electrical Appliance"]},{"type":"string","enum":["Electronics"]},{"type":"string","enum":["Battery"]},{"type":"string","enum":["Toy"]},{"type":"string","enum":["Baby Product"]},{"type":"string","enum":["Clothing"]},{"type":"string","enum":["Textile"]},{"type":"string","enum":["Chemical"]},{"type":"string","enum":["Detergent"]},{"type":"string","enum":["Household Product"]},{"type":"string","enum":["Furniture"]},{"type":"string","enum":["Kitchenware"]},{"type":"string","enum":["Container / Packaging"]},{"type":"string","enum":["Agricultural Product"]},{"type":"string","enum":["Plant"]},{"type":"string","enum":["Animal Product"]},{"type":"string","enum":["Pet Product"]},{"type":"string","enum":["Pet Food"]},{"type":"string","enum":["Alcohol"]},{"type":"string","enum":["Tobacco / Nicotine"]},{"type":"string","enum":["Vehicle / Parts"]},{"type":"string","enum":["Machinery"]},{"type":"string","enum":["Radio Equipment"]},{"type":"string","enum":["Luxury Goods"]},{"type":"string","enum":["Wildlife Product"]},{"type":"string","enum":["General Goods"]},{"type":"string","enum":["Unknown"]}]},"intended_use":{"anyOf":[{"type":"string"},{"type":"null"}]},"origin_country":{"anyOf":[{"type":"string"},{"type":"null"}]},"hs_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"destination_country":{"type":"string","enum":["JP"]}}},"missing_information":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["field","label","question"],"properties":{"field":{"type":"string"},"label":{"type":"string"},"question":{"type":"string"},"priority":{"anyOf":[{"type":"string","enum":["CRITICAL"]},{"type":"string","enum":["HIGH"]},{"type":"string","enum":["MEDIUM"]},{"type":"string","enum":["LOW"]}]},"reason":{"type":"string"}}}},"requirements":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["type","name","authority","rule_id"],"properties":{"type":{"type":"string"},"name":{"type":"string"},"authority":{"type":"string"},"rule_id":{"type":"string"}}}},"restrictions":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["name","authority","rule_id"],"properties":{"name":{"type":"string"},"authority":{"type":"string"},"rule_id":{"type":"string"}}}},"rules_checked":{"type":"array","items":{"type":"string"}},"authorities_checked":{"type":"array","items":{"type":"string"}},"official_sources":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["source_id","source_name","organization","official_url","version","last_checked_at","retrieved_at","effective_from","update_frequency","status","fallback_used"],"properties":{"source_id":{"type":"string"},"source_name":{"type":"string"},"organization":{"type":"string"},"official_url":{"format":"uri","type":"string"},"version":{"anyOf":[{"type":"string"},{"type":"null"}]},"last_checked_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"retrieved_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"effective_from":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"update_frequency":{"type":"string"},"status":{"type":"string"},"fallback_used":{"type":"boolean"}}}},"additional_checks":{"type":"array","items":{"type":"string"}},"data_freshness":{"additionalProperties":false,"type":"object","required":["engine","phase4_version","regulatory_version","customs_version","assessed_at"],"properties":{"engine":{"type":"string","enum":["phase4"]},"phase4_version":{"type":"string"},"regulatory_version":{"type":"string"},"customs_version":{"type":"string"},"assessed_at":{"format":"date-time","type":"string"}}},"usage":{"additionalProperties":false,"type":"object","required":["counted","channel"],"properties":{"counted":{"type":"boolean"},"channel":{"anyOf":[{"type":"string","enum":["anonymous_demo"]},{"type":"string","enum":["api_key"]}]}}},"disclaimer":{"type":"string"}},"title":"SellabilityResponse"}}}}}},"security":[{"bearerApiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","status","estimated_selling_price_jpy","estimated_total_cost_jpy","estimated_profit_jpy","profit_margin_percent","break_even_price_jpy","recommended_min_price_jpy","confidence","recommendation","summary","cost_breakdown","assumptions","confidence_factors","missing_fields","warnings","sellability","data_freshness","sources","metadata","disclaimer"],"properties":{"request_id":{"pattern":"^req_[a-f0-9]{32}$","type":"string"},"success":{"type":"boolean","enum":[true]},"status":{"anyOf":[{"type":"string","enum":["HIGHLY_PROFITABLE"]},{"type":"string","enum":["PROFITABLE"]},{"type":"string","enum":["LOW_MARGIN"]},{"type":"string","enum":["BREAK_EVEN"]},{"type":"string","enum":["UNPROFITABLE"]},{"type":"string","enum":["INSUFFICIENT_DATA"]}]},"estimated_selling_price_jpy":{"type":"number"},"estimated_total_cost_jpy":{"type":"number"},"estimated_profit_jpy":{"type":"number"},"profit_margin_percent":{"type":"number"},"break_even_price_jpy":{"type":"number"},"recommended_min_price_jpy":{"type":"number"},"confidence":{"minimum":0,"maximum":100,"type":"integer"},"recommendation":{"anyOf":[{"type":"string","enum":["ENTER_MARKET"]},{"type":"string","enum":["CONSIDER_WITH_CONDITIONS"]},{"type":"string","enum":["REVIEW_BEFORE_ENTRY"]},{"type":"string","enum":["DO_NOT_ENTER"]}]},"summary":{"type":"string"},"cost_breakdown":{"additionalProperties":false,"type":"object","required":["product_cost_jpy","international_shipping_jpy","insurance_jpy","customs_duty_jpy","import_tax_jpy","customs_clearance_jpy","domestic_logistics_jpy","platform_fee_jpy","payment_fee_jpy","fixed_channel_fee_jpy","other_costs_jpy"],"properties":{"product_cost_jpy":{"type":"number"},"international_shipping_jpy":{"type":"number"},"insurance_jpy":{"type":"number"},"customs_duty_jpy":{"type":"number"},"import_tax_jpy":{"type":"number"},"customs_clearance_jpy":{"type":"number"},"domestic_logistics_jpy":{"type":"number"},"platform_fee_jpy":{"type":"number"},"payment_fee_jpy":{"type":"number"},"fixed_channel_fee_jpy":{"type":"number"},"other_costs_jpy":{"type":"number"}}},"assumptions":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["field","value","provenance","classification","reason"],"properties":{"field":{"type":"string"},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},"provenance":{"anyOf":[{"type":"string","enum":["official"]},{"type":"string","enum":["provided"]},{"type":"string","enum":["estimated"]},{"type":"string","enum":["default"]}]},"classification":{"anyOf":[{"type":"string","enum":["CONFIRMED"]},{"type":"string","enum":["CONDITIONAL"]},{"type":"string","enum":["USER_INPUT"]},{"type":"string","enum":["ASSUMPTION"]},{"type":"string","enum":["MISSING"]}]},"reason":{"type":"string"},"source_id":{"type":"string"}}}},"confidence_factors":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["field","weight","classification","awarded_points","reason"],"properties":{"field":{"type":"string"},"weight":{"minimum":1,"maximum":100,"type":"integer"},"classification":{"anyOf":[{"type":"string","enum":["CONFIRMED"]},{"type":"string","enum":["CONDITIONAL"]},{"type":"string","enum":["USER_INPUT"]},{"type":"string","enum":["ASSUMPTION"]},{"type":"string","enum":["MISSING"]}]},"awarded_points":{"minimum":0,"maximum":100,"type":"number"},"reason":{"type":"string"}}}},"missing_fields":{"type":"array","items":{"type":"string"}},"warnings":{"type":"array","items":{"type":"string"}},"sellability":{"additionalProperties":false,"type":"object","required":["supplied","status","request_id","reused_fields","requirement_count","restriction_count"],"properties":{"supplied":{"type":"boolean"},"status":{"anyOf":[{"anyOf":[{"type":"string","enum":["SELLABLE"]},{"type":"string","enum":["SELLABLE_WITH_CONDITIONS"]},{"type":"string","enum":["REVIEW_REQUIRED"]},{"type":"string","enum":["NOT_SELLABLE"]}]},{"type":"null"}]},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"reused_fields":{"type":"array","items":{"type":"string"}},"requirement_count":{"minimum":0,"type":"integer"},"restriction_count":{"minimum":0,"type":"integer"}}},"data_freshness":{"additionalProperties":false,"type":"object","required":["engine","tariff_version","fx_version","fx_period_start","fx_period_end","fx_retrieved_at","fx_source_url","fx_status","fee_version","fee_checked_at","calculated_at"],"properties":{"engine":{"type":"string","enum":["profitability-v1"]},"tariff_version":{"anyOf":[{"type":"string"},{"type":"null"}]},"fx_version":{"anyOf":[{"type":"string"},{"type":"null"}]},"fx_period_start":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"fx_period_end":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"fx_retrieved_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"fx_source_url":{"anyOf":[{"format":"uri","type":"string"},{"type":"null"}]},"fx_status":{"anyOf":[{"type":"string","enum":["CURRENT"]},{"type":"string","enum":["STALE"]},{"type":"string","enum":["MISSING"]}]},"fee_version":{"type":"string"},"fee_checked_at":{"format":"date","type":"string"},"calculated_at":{"format":"date-time","type":"string"}}},"sources":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["source_id","source_name","organization","official_url","version","effective_from","checked_at"],"properties":{"source_id":{"type":"string"},"source_name":{"type":"string"},"organization":{"type":"string"},"official_url":{"format":"uri","type":"string"},"version":{"anyOf":[{"type":"string"},{"type":"null"}]},"effective_from":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"checked_at":{"format":"date","type":"string"}}}},"metadata":{"additionalProperties":false,"type":"object","required":["target_market","channel","currency","calculation_method"],"properties":{"target_market":{"type":"string","enum":["JP"]},"channel":{"anyOf":[{"type":"string","enum":["amazon_jp"]},{"type":"string","enum":["rakuten"]},{"type":"string","enum":["yahoo_japan"]},{"type":"string","enum":["own_ec"]}]},"currency":{"type":"string","enum":["JPY"]},"calculation_method":{"type":"string","enum":["deterministic_cost_model_v1"]}}},"disclaimer":{"type":"string"}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["request_id","success","error"],"properties":{"request_id":{"type":"string"},"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}}}}},"/v1/japan/company/verify":{"post":{"operationId":"japan_company_verify","summary":"日本企業確認API","description":"企業名・法人番号から日本法人の実在、正式名称、所在地を確認するときに使います。インボイス登録状態だけを知りたい場合は japan_invoice_verify、名称の表記統一だけなら japan_company_name_normalize を使ってください。必須入力は query。候補が一意でない場合は断定せず候補を返します。推奨例: {\"query\":\"株式会社サンプル\",\"prefecture\":\"東京都\"}。","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["query"],"properties":{"query":{"minLength":1,"maxLength":120,"description":"企業名、13桁の法人番号、またはT付き登録番号","type":"string"},"prefecture":{"minLength":2,"maxLength":16,"type":"string"},"limit":{"minimum":1,"maximum":20,"default":10,"type":"integer"}}}}}},"security":[{"bearerApiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","data","confidence","source","updated_at","request_id","warnings"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"additionalProperties":false,"type":"object","required":["exists","status","official_name","normalized_name","corporate_number","address","corporate_status","candidates"],"properties":{"exists":{"type":"boolean"},"status":{"anyOf":[{"type":"string","enum":["matched"]},{"type":"string","enum":["ambiguous"]},{"type":"string","enum":["not_found"]}]},"official_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"normalized_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"corporate_number":{"anyOf":[{"type":"string"},{"type":"null"}]},"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"corporate_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"candidates":{"maxItems":20,"type":"array","items":{"additionalProperties":false,"type":"object","required":["corporate_number","official_name","address","match_score"],"properties":{"corporate_number":{"type":"string"},"official_name":{"type":"string"},"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"match_score":{"minimum":0,"maximum":1,"type":"number"}}}}}},"confidence":{"minimum":0,"maximum":1,"description":"根拠の充足度を0〜1で表す参考値。法的保証や確率ではありません。","type":"number"},"source":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["source_id","name","url","updated_at"],"properties":{"source_id":{"type":"string"},"name":{"type":"string"},"url":{"anyOf":[{"format":"uri","type":"string"},{"type":"null"}]},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"request_id":{"pattern":"^req_[a-f0-9]{32}$","type":"string"},"warnings":{"type":"array","items":{"type":"string"}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}}}}},"/v1/japan/address/verify":{"post":{"operationId":"japan_address_verify","summary":"日本住所検証API","description":"配送先・申込住所など、日本住所の存在確認、郵便番号照合、全角半角・丁目番地の正規化に使います。企業の実在確認には japan_company_verify、自治体コードだけの取得には japan_municipality_lookup を使ってください。address または postal_code が必須です。建物・部屋番号を公的データで確認できない場合は unmatched_text と warnings に残します。","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"anyOf":[{"required":["address"]},{"required":["postal_code"]}],"type":"object","properties":{"address":{"minLength":1,"maxLength":512,"description":"検証・正規化する日本住所","type":"string"},"postal_code":{"minLength":7,"maxLength":8,"pattern":"^[0-9０-９]{3}-?[0-9０-９]{4}$","description":"住所と照合する郵便番号","type":"string"}}}}}},"security":[{"bearerApiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","data","confidence","source","updated_at","request_id","warnings"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"additionalProperties":false,"type":"object","required":["exists","status","original","normalized_address","postal_code","prefecture","municipality","municipality_code","town_area","unmatched_text","candidates"],"properties":{"exists":{"type":"boolean"},"status":{"anyOf":[{"type":"string","enum":["matched"]},{"type":"string","enum":["partial"]},{"type":"string","enum":["ambiguous"]},{"type":"string","enum":["not_found"]}]},"original":{"type":"string"},"normalized_address":{"anyOf":[{"type":"string"},{"type":"null"}]},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"prefecture":{"anyOf":[{"type":"string"},{"type":"null"}]},"municipality":{"anyOf":[{"type":"string"},{"type":"null"}]},"municipality_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"town_area":{"anyOf":[{"type":"string"},{"type":"null"}]},"unmatched_text":{"anyOf":[{"type":"string"},{"type":"null"}]},"candidates":{"maxItems":10,"type":"array","items":{"additionalProperties":false,"type":"object","required":["postal_code","normalized_address","municipality_code","score"],"properties":{"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"normalized_address":{"anyOf":[{"type":"string"},{"type":"null"}]},"municipality_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"score":{"minimum":0,"maximum":1,"type":"number"}}}}}},"confidence":{"minimum":0,"maximum":1,"description":"根拠の充足度を0〜1で表す参考値。法的保証や確率ではありません。","type":"number"},"source":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["source_id","name","url","updated_at"],"properties":{"source_id":{"type":"string"},"name":{"type":"string"},"url":{"anyOf":[{"format":"uri","type":"string"},{"type":"null"}]},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"request_id":{"pattern":"^req_[a-f0-9]{32}$","type":"string"},"warnings":{"type":"array","items":{"type":"string"}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}}}}},"/v1/japan/invoice/verify":{"post":{"operationId":"japan_invoice_verify","summary":"インボイス登録確認API","description":"適格請求書発行事業者の登録状態だけを確認するときに使います。企業の総合的な実在確認には japan_company_verify を使ってください。registration_number、corporate_number、company_name のいずれかが必須です。名称検索が一意でなければ登録を推測せず ambiguous と候補を返します。","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"anyOf":[{"required":["registration_number"]},{"required":["corporate_number"]},{"required":["company_name"]}],"type":"object","properties":{"registration_number":{"pattern":"^[TtＴｔ]?[0-9０-９]{13}$","type":"string"},"corporate_number":{"pattern":"^[0-9０-９]{13}$","type":"string"},"company_name":{"minLength":1,"maxLength":120,"type":"string"},"prefecture":{"minLength":2,"maxLength":16,"type":"string"}}}}}},"security":[{"bearerApiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","data","confidence","source","updated_at","request_id","warnings"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"additionalProperties":false,"type":"object","required":["status","registered","valid","registration_number","corporate_number","name","address","registration_date","cancellation_date","expiration_date","checked_at","data_updated_at","candidates"],"properties":{"status":{"anyOf":[{"type":"string","enum":["registered"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["expired"]},{"type":"string","enum":["not_registered"]},{"type":"string","enum":["ambiguous"]},{"type":"string","enum":["unavailable"]}]},"registered":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"valid":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"registration_number":{"anyOf":[{"type":"string"},{"type":"null"}]},"corporate_number":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"registration_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"cancellation_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"expiration_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"checked_at":{"type":"string"},"data_updated_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"candidates":{"maxItems":20,"type":"array","items":{"additionalProperties":false,"type":"object","required":["corporate_number","official_name","address","match_score"],"properties":{"corporate_number":{"type":"string"},"official_name":{"type":"string"},"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"match_score":{"minimum":0,"maximum":1,"type":"number"}}}}}},"confidence":{"minimum":0,"maximum":1,"description":"根拠の充足度を0〜1で表す参考値。法的保証や確率ではありません。","type":"number"},"source":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["source_id","name","url","updated_at"],"properties":{"source_id":{"type":"string"},"name":{"type":"string"},"url":{"anyOf":[{"format":"uri","type":"string"},{"type":"null"}]},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"request_id":{"pattern":"^req_[a-f0-9]{32}$","type":"string"},"warnings":{"type":"array","items":{"type":"string"}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}}}}},"/v1/japan/company-name/normalize":{"post":{"operationId":"japan_company_name_normalize","summary":"日本企業名正規化API","description":"CRM、顧客台帳、検索インデックスで企業名を比較可能な形へ揃えるときに使います。企業が実在するかの確認には japan_company_verify を使ってください。必須入力は company_name。全角半角、空白、記号、法人格の前株・後株、KK、Co., Ltd. を決定的に正規化し、候補と実施手順を返します。","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["company_name"],"properties":{"company_name":{"minLength":1,"maxLength":120,"type":"string"}}}}}},"security":[{"bearerApiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","data","confidence","source","updated_at","request_id","warnings"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"additionalProperties":false,"type":"object","required":["original","normalized","display","corporate_type","corporate_type_position","candidates","normalization_steps"],"properties":{"original":{"type":"string"},"normalized":{"type":"string"},"display":{"type":"string"},"corporate_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"corporate_type_position":{"anyOf":[{"type":"string","enum":["prefix"]},{"type":"string","enum":["suffix"]},{"type":"string","enum":["none"]},{"type":"string","enum":["unknown"]}]},"candidates":{"maxItems":20,"type":"array","items":{"type":"string"}},"normalization_steps":{"type":"array","items":{"type":"string"}}}},"confidence":{"minimum":0,"maximum":1,"description":"根拠の充足度を0〜1で表す参考値。法的保証や確率ではありません。","type":"number"},"source":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["source_id","name","url","updated_at"],"properties":{"source_id":{"type":"string"},"name":{"type":"string"},"url":{"anyOf":[{"format":"uri","type":"string"},{"type":"null"}]},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"request_id":{"pattern":"^req_[a-f0-9]{32}$","type":"string"},"warnings":{"type":"array","items":{"type":"string"}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}}}}},"/v1/japan/municipality/lookup":{"post":{"operationId":"japan_municipality_lookup","summary":"日本自治体情報API","description":"住所・郵便番号・自治体名から都道府県、市区町村、自治体コードを取得するときに使います。住所全体の存在・番地・建物検証には japan_address_verify を使ってください。必須入力は query。複数自治体に該当する場合は候補を返し、単一自治体を推測しません。","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["query"],"properties":{"query":{"minLength":1,"maxLength":512,"description":"住所、郵便番号、自治体名のいずれか","type":"string"}}}}}},"security":[{"bearerApiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","data","confidence","source","updated_at","request_id","warnings"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"additionalProperties":false,"type":"object","required":["found","prefecture","prefecture_code","municipality","municipality_code","postal_code","normalized_address","candidates"],"properties":{"found":{"type":"boolean"},"prefecture":{"anyOf":[{"type":"string"},{"type":"null"}]},"prefecture_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"municipality":{"anyOf":[{"type":"string"},{"type":"null"}]},"municipality_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"normalized_address":{"anyOf":[{"type":"string"},{"type":"null"}]},"candidates":{"maxItems":10,"type":"array","items":{"additionalProperties":false,"type":"object","required":["prefecture","municipality","municipality_code","postal_code","score"],"properties":{"prefecture":{"anyOf":[{"type":"string"},{"type":"null"}]},"municipality":{"anyOf":[{"type":"string"},{"type":"null"}]},"municipality_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"score":{"minimum":0,"maximum":1,"type":"number"}}}}}},"confidence":{"minimum":0,"maximum":1,"description":"根拠の充足度を0〜1で表す参考値。法的保証や確率ではありません。","type":"number"},"source":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["source_id","name","url","updated_at"],"properties":{"source_id":{"type":"string"},"name":{"type":"string"},"url":{"anyOf":[{"format":"uri","type":"string"},{"type":"null"}]},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"request_id":{"pattern":"^req_[a-f0-9]{32}$","type":"string"},"warnings":{"type":"array","items":{"type":"string"}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}}}}},"/v1/japan/product/sellability":{"post":{"operationId":"japan_product_sellability","summary":"日本商品販売可否判定API","description":"『この商品を日本で売れるか』という販売可否の一次判定に使います。必要な許可・届出・表示を手順別に知りたい場合は japan_product_compliance、利益を計算したい場合は japan_profit_calculate を使ってください。product_name と category が必須です。不足情報や公的根拠が足りない場合は確認必要とし、販売可能を推測しません。","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["product_name","category"],"properties":{"product_name":{"minLength":1,"maxLength":160,"type":"string"},"category":{"anyOf":[{"type":"string","enum":["Food"]},{"type":"string","enum":["Beverage"]},{"type":"string","enum":["Supplement"]},{"type":"string","enum":["Cosmetics"]},{"type":"string","enum":["Pharmaceutical"]},{"type":"string","enum":["Quasi-drug"]},{"type":"string","enum":["Medical Device"]},{"type":"string","enum":["Electrical Appliance"]},{"type":"string","enum":["Electronics"]},{"type":"string","enum":["Battery"]},{"type":"string","enum":["Toy"]},{"type":"string","enum":["Baby Product"]},{"type":"string","enum":["Clothing"]},{"type":"string","enum":["Textile"]},{"type":"string","enum":["Chemical"]},{"type":"string","enum":["Detergent"]},{"type":"string","enum":["Household Product"]},{"type":"string","enum":["Furniture"]},{"type":"string","enum":["Kitchenware"]},{"type":"string","enum":["Container / Packaging"]},{"type":"string","enum":["Agricultural Product"]},{"type":"string","enum":["Plant"]},{"type":"string","enum":["Animal Product"]},{"type":"string","enum":["Pet Product"]},{"type":"string","enum":["Pet Food"]},{"type":"string","enum":["Alcohol"]},{"type":"string","enum":["Tobacco / Nicotine"]},{"type":"string","enum":["Vehicle / Parts"]},{"type":"string","enum":["Machinery"]},{"type":"string","enum":["Radio Equipment"]},{"type":"string","enum":["Luxury Goods"]},{"type":"string","enum":["Wildlife Product"]},{"type":"string","enum":["General Goods"]},{"type":"string","enum":["Unknown"]}]},"description":{"minLength":1,"maxLength":1000,"type":"string"},"intended_use":{"minLength":1,"maxLength":500,"type":"string"},"materials":{"maxItems":16,"type":"array","items":{"minLength":1,"maxLength":120,"type":"string"}},"uses_power":{"type":"boolean"},"wireless_function":{"type":"boolean"},"food_contact":{"type":"boolean"},"chemicals_or_ingredients":{"maxItems":32,"type":"array","items":{"minLength":1,"maxLength":160,"type":"string"}},"medical_purpose":{"type":"boolean"},"target_age":{"anyOf":[{"minimum":0,"maximum":150,"type":"number"},{"minLength":1,"maxLength":60,"type":"string"}]},"origin_country":{"minLength":2,"maxLength":80,"type":"string"},"hs_code":{"minLength":4,"maxLength":16,"pattern":"^[0-9. -]+$","type":"string"},"notes":{"minLength":1,"maxLength":1000,"type":"string"}}}}}},"security":[{"bearerApiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","data","confidence","source","updated_at","request_id","warnings"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"additionalProperties":false,"type":"object","required":["judgment","status","reason","related_authorities","related_laws","missing_information","next_actions"],"properties":{"judgment":{"anyOf":[{"type":"string","enum":["販売可能"]},{"type":"string","enum":["条件付き販売可能"]},{"type":"string","enum":["確認必要"]},{"type":"string","enum":["販売不可"]}]},"status":{"anyOf":[{"type":"string","enum":["SELLABLE"]},{"type":"string","enum":["SELLABLE_WITH_CONDITIONS"]},{"type":"string","enum":["REVIEW_REQUIRED"]},{"type":"string","enum":["NOT_SELLABLE"]}]},"reason":{"type":"string"},"related_authorities":{"type":"array","items":{"type":"string"}},"related_laws":{"type":"array","items":{"type":"string"}},"missing_information":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["field","question"],"properties":{"field":{"type":"string"},"question":{"type":"string"}}}},"next_actions":{"type":"array","items":{"type":"string"}}}},"confidence":{"minimum":0,"maximum":1,"description":"根拠の充足度を0〜1で表す参考値。法的保証や確率ではありません。","type":"number"},"source":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["source_id","name","url","updated_at"],"properties":{"source_id":{"type":"string"},"name":{"type":"string"},"url":{"anyOf":[{"format":"uri","type":"string"},{"type":"null"}]},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"request_id":{"pattern":"^req_[a-f0-9]{32}$","type":"string"},"warnings":{"type":"array","items":{"type":"string"}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}}}}},"/v1/japan/product/compliance":{"post":{"operationId":"japan_product_compliance","summary":"日本商品規制・必要手続判定API","description":"『日本で売るために何をしなければならないか』を法令、所管省庁、届出、許可、認証、表示、検査に分けるときに使います。単純な販売可否だけなら japan_product_sellability、採算性なら japan_profit_calculate を使ってください。product_name と category が必須です。法的保証ではなく、公的情報に基づく確認手順を返します。","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["product_name","category"],"properties":{"product_name":{"minLength":1,"maxLength":160,"type":"string"},"category":{"anyOf":[{"type":"string","enum":["Food"]},{"type":"string","enum":["Beverage"]},{"type":"string","enum":["Supplement"]},{"type":"string","enum":["Cosmetics"]},{"type":"string","enum":["Pharmaceutical"]},{"type":"string","enum":["Quasi-drug"]},{"type":"string","enum":["Medical Device"]},{"type":"string","enum":["Electrical Appliance"]},{"type":"string","enum":["Electronics"]},{"type":"string","enum":["Battery"]},{"type":"string","enum":["Toy"]},{"type":"string","enum":["Baby Product"]},{"type":"string","enum":["Clothing"]},{"type":"string","enum":["Textile"]},{"type":"string","enum":["Chemical"]},{"type":"string","enum":["Detergent"]},{"type":"string","enum":["Household Product"]},{"type":"string","enum":["Furniture"]},{"type":"string","enum":["Kitchenware"]},{"type":"string","enum":["Container / Packaging"]},{"type":"string","enum":["Agricultural Product"]},{"type":"string","enum":["Plant"]},{"type":"string","enum":["Animal Product"]},{"type":"string","enum":["Pet Product"]},{"type":"string","enum":["Pet Food"]},{"type":"string","enum":["Alcohol"]},{"type":"string","enum":["Tobacco / Nicotine"]},{"type":"string","enum":["Vehicle / Parts"]},{"type":"string","enum":["Machinery"]},{"type":"string","enum":["Radio Equipment"]},{"type":"string","enum":["Luxury Goods"]},{"type":"string","enum":["Wildlife Product"]},{"type":"string","enum":["General Goods"]},{"type":"string","enum":["Unknown"]}]},"description":{"minLength":1,"maxLength":1000,"type":"string"},"intended_use":{"minLength":1,"maxLength":500,"type":"string"},"materials":{"maxItems":16,"type":"array","items":{"minLength":1,"maxLength":120,"type":"string"}},"uses_power":{"type":"boolean"},"wireless_function":{"type":"boolean"},"food_contact":{"type":"boolean"},"chemicals_or_ingredients":{"maxItems":32,"type":"array","items":{"minLength":1,"maxLength":160,"type":"string"}},"medical_purpose":{"type":"boolean"},"target_age":{"anyOf":[{"minimum":0,"maximum":150,"type":"number"},{"minLength":1,"maxLength":60,"type":"string"}]},"origin_country":{"minLength":2,"maxLength":80,"type":"string"},"hs_code":{"minLength":4,"maxLength":16,"pattern":"^[0-9. -]+$","type":"string"},"notes":{"minLength":1,"maxLength":1000,"type":"string"}}}}}},"security":[{"bearerApiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","data","confidence","source","updated_at","request_id","warnings"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"additionalProperties":false,"type":"object","required":["status","related_laws","related_authorities","notifications","permits","certifications","labeling","inspections","import_notes","sales_notes","recommended_actions"],"properties":{"status":{"anyOf":[{"type":"string","enum":["READY"]},{"type":"string","enum":["CONDITIONS_REQUIRED"]},{"type":"string","enum":["REVIEW_REQUIRED"]},{"type":"string","enum":["BLOCKED"]}]},"related_laws":{"type":"array","items":{"type":"string"}},"related_authorities":{"type":"array","items":{"type":"string"}},"notifications":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["type","name","authority","rule_id"],"properties":{"type":{"type":"string"},"name":{"type":"string"},"authority":{"type":"string"},"rule_id":{"type":"string"}}}},"permits":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["type","name","authority","rule_id"],"properties":{"type":{"type":"string"},"name":{"type":"string"},"authority":{"type":"string"},"rule_id":{"type":"string"}}}},"certifications":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["type","name","authority","rule_id"],"properties":{"type":{"type":"string"},"name":{"type":"string"},"authority":{"type":"string"},"rule_id":{"type":"string"}}}},"labeling":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["type","name","authority","rule_id"],"properties":{"type":{"type":"string"},"name":{"type":"string"},"authority":{"type":"string"},"rule_id":{"type":"string"}}}},"inspections":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["type","name","authority","rule_id"],"properties":{"type":{"type":"string"},"name":{"type":"string"},"authority":{"type":"string"},"rule_id":{"type":"string"}}}},"import_notes":{"type":"array","items":{"type":"string"}},"sales_notes":{"type":"array","items":{"type":"string"}},"recommended_actions":{"type":"array","items":{"type":"string"}}}},"confidence":{"minimum":0,"maximum":1,"description":"根拠の充足度を0〜1で表す参考値。法的保証や確率ではありません。","type":"number"},"source":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["source_id","name","url","updated_at"],"properties":{"source_id":{"type":"string"},"name":{"type":"string"},"url":{"anyOf":[{"format":"uri","type":"string"},{"type":"null"}]},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"request_id":{"pattern":"^req_[a-f0-9]{32}$","type":"string"},"warnings":{"type":"array","items":{"type":"string"}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}}}}},"/v1/japan/profit/calculate":{"post":{"operationId":"japan_profit_calculate","summary":"日本販売利益計算API","description":"日本で販売した場合の売上、原価、関税等、推定利益、利益率を計算するときに使います。販売できるかだけなら japan_product_sellability、必要手続だけなら japan_product_compliance を使ってください。product_name、cost、selling_price が必須で、金額は1個あたりです。quantityを指定すると合計値を返します。","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["product_name","cost","selling_price"],"properties":{"product_name":{"minLength":1,"maxLength":160,"type":"string"},"cost":{"minimum":0,"maximum":1000000000,"description":"1個あたりの原価","type":"number"},"selling_price":{"minimum":0,"maximum":1000000000,"description":"1個あたりの販売予定価格","type":"number"},"currency":{"minLength":3,"maxLength":3,"default":"JPY","pattern":"^[A-Za-z]{3}$","type":"string"},"origin_country":{"minLength":2,"maxLength":80,"type":"string"},"category":{"anyOf":[{"type":"string","enum":["Food"]},{"type":"string","enum":["Beverage"]},{"type":"string","enum":["Supplement"]},{"type":"string","enum":["Cosmetics"]},{"type":"string","enum":["Pharmaceutical"]},{"type":"string","enum":["Quasi-drug"]},{"type":"string","enum":["Medical Device"]},{"type":"string","enum":["Electrical Appliance"]},{"type":"string","enum":["Electronics"]},{"type":"string","enum":["Battery"]},{"type":"string","enum":["Toy"]},{"type":"string","enum":["Baby Product"]},{"type":"string","enum":["Clothing"]},{"type":"string","enum":["Textile"]},{"type":"string","enum":["Chemical"]},{"type":"string","enum":["Detergent"]},{"type":"string","enum":["Household Product"]},{"type":"string","enum":["Furniture"]},{"type":"string","enum":["Kitchenware"]},{"type":"string","enum":["Container / Packaging"]},{"type":"string","enum":["Agricultural Product"]},{"type":"string","enum":["Plant"]},{"type":"string","enum":["Animal Product"]},{"type":"string","enum":["Pet Product"]},{"type":"string","enum":["Pet Food"]},{"type":"string","enum":["Alcohol"]},{"type":"string","enum":["Tobacco / Nicotine"]},{"type":"string","enum":["Vehicle / Parts"]},{"type":"string","enum":["Machinery"]},{"type":"string","enum":["Radio Equipment"]},{"type":"string","enum":["Luxury Goods"]},{"type":"string","enum":["Wildlife Product"]},{"type":"string","enum":["General Goods"]},{"type":"string","enum":["Unknown"]}]},"quantity":{"minimum":1,"maximum":10000000,"default":1,"type":"integer"},"hs_code":{"minLength":4,"maxLength":16,"pattern":"^[0-9. -]+$","type":"string"},"channel":{"anyOf":[{"type":"string","enum":["amazon_jp"]},{"type":"string","enum":["rakuten"]},{"type":"string","enum":["yahoo_japan"]},{"type":"string","enum":["own_ec"]}]},"international_shipping":{"minimum":0,"maximum":1000000000,"type":"number"},"insurance":{"minimum":0,"maximum":1000000000,"type":"number"},"customs_clearance":{"minimum":0,"maximum":1000000000,"type":"number"},"domestic_logistics":{"minimum":0,"maximum":1000000000,"type":"number"},"duty_rate_percent":{"minimum":0,"maximum":1000,"type":"number"},"check_sellability":{"default":true,"type":"boolean"}}}}}},"security":[{"bearerApiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","data","confidence","source","updated_at","request_id","warnings"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"additionalProperties":false,"type":"object","required":["quantity","estimated_revenue","estimated_product_cost","estimated_total_cost","customs_and_import_tax","estimated_profit","estimated_profit_margin_percent","break_even_price_per_unit","sellability_status","calculation_basis","currency"],"properties":{"quantity":{"minimum":1,"type":"integer"},"estimated_revenue":{"type":"number"},"estimated_product_cost":{"type":"number"},"estimated_total_cost":{"type":"number"},"customs_and_import_tax":{"type":"number"},"estimated_profit":{"type":"number"},"estimated_profit_margin_percent":{"type":"number"},"break_even_price_per_unit":{"type":"number"},"sellability_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"calculation_basis":{"type":"array","items":{"type":"string"}},"currency":{"type":"string","enum":["JPY"]}}},"confidence":{"minimum":0,"maximum":1,"description":"根拠の充足度を0〜1で表す参考値。法的保証や確率ではありません。","type":"number"},"source":{"type":"array","items":{"additionalProperties":false,"type":"object","required":["source_id","name","url","updated_at"],"properties":{"source_id":{"type":"string"},"name":{"type":"string"},"url":{"anyOf":[{"format":"uri","type":"string"},{"type":"null"}]},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"request_id":{"pattern":"^req_[a-f0-9]{32}$","type":"string"},"warnings":{"type":"array","items":{"type":"string"}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"additionalProperties":false,"type":"object","required":["code","message","retryable","suggested_action"],"properties":{"code":{"type":"string"},"message":{"description":"利用者向けの日本語エラーメッセージ","type":"string"},"retryable":{"type":"boolean"},"suggested_action":{"type":"string"}}},"request_id":{"type":"string"}}}}}}}}},"/mcp":{"get":{"responses":{"200":{"description":"Default Response"}}},"delete":{"responses":{"200":{"description":"Default Response"}}},"post":{"responses":{"200":{"description":"Default Response"}}}}},"servers":[{"url":"https://api.japanapistore.com","description":"JAPAN API STORE API"}]}