{"openapi":"3.1.0","info":{"title":"Japan Data API","version":"0.1.0","description":"Agent-first Japanese public data API. Paid endpoints return HTTP 402 and accept x402 payments.","contact":{"name":"Japan Data API","email":"support@koelink.co.jp"}},"servers":[{"url":"https://japan-data-api-x402.fly.dev"}],"paths":{"/v1/companies/search":{"get":{"operationId":"companies_search","summary":"Search Japanese companies","description":"Search companies by name, prefecture, or corporate number.","tags":["companies","registry"],"parameters":[{"name":"q","in":"query","required":true,"description":"Company name (partial match)","schema":{"type":"string"},"example":"サンプル"},{"name":"prefecture","in":"query","required":false,"description":"Prefecture name","schema":{"type":"string"},"example":"東京都"},{"name":"corporate_number","in":"query","required":false,"description":"13-digit corporate number","schema":{"type":"string"},"example":"1010001000001"},{"name":"limit","in":"query","required":false,"description":"1-50 (default 20)","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"1-10 (default 1)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response (payment settled)","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request"},"402":{"description":"Payment required. Pay with x402 and retry.","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 PaymentRequired object","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found"}}}},"/v1/companies/{corporate_number}":{"get":{"operationId":"companies_get","summary":"Get a Japanese company","description":"Get basic registry information and change history for a corporate number.","tags":["companies","registry"],"parameters":[{"name":"corporate_number","in":"path","required":true,"description":"13-digit Japanese corporate number","schema":{"type":"string","pattern":"^\\d{13}$"},"example":"1180301018771"}],"responses":{"200":{"description":"Successful response (payment settled)","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request"},"402":{"description":"Payment required. Pay with x402 and retry.","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 PaymentRequired object","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found"}}}},"/v1/companies/{corporate_number}/financials":{"get":{"operationId":"companies_financials","summary":"Get company financials","description":"Get a normalized financial summary from EDINET disclosures.","tags":["companies","finance","edinet"],"parameters":[{"name":"corporate_number","in":"path","required":true,"description":"13-digit Japanese corporate number","schema":{"type":"string","pattern":"^\\d{13}$"},"example":"1180301018771"},{"name":"fiscal_year","in":"query","required":false,"description":"Fiscal year (e.g. 2025)","schema":{"type":"string"},"example":"2025"}],"responses":{"200":{"description":"Successful response (payment settled)","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request"},"402":{"description":"Payment required. Pay with x402 and retry.","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 PaymentRequired object","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found"}}}},"/v1/companies/{corporate_number}/sanctions":{"get":{"operationId":"companies_sanctions","summary":"Get company sanctions","description":"Get administrative sanctions and warnings linked to a corporate number.","tags":["companies","compliance"],"parameters":[{"name":"corporate_number","in":"path","required":true,"description":"13-digit Japanese corporate number","schema":{"type":"string","pattern":"^\\d{13}$"},"example":"1180301018771"}],"responses":{"200":{"description":"Successful response (payment settled)","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request"},"402":{"description":"Payment required. Pay with x402 and retry.","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 PaymentRequired object","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found"}}}},"/v1/companies/{corporate_number}/risk-profile":{"get":{"operationId":"companies_risk_profile","summary":"Get a company risk profile","description":"One call bundle: registry, financials, sanctions, matching subsidies, tenders, awards, and a heuristic risk score.","tags":["companies","risk","compliance","bundle"],"parameters":[{"name":"corporate_number","in":"path","required":true,"description":"13-digit Japanese corporate number","schema":{"type":"string","pattern":"^\\d{13}$"},"example":"1180301018771"},{"name":"fiscal_year","in":"query","required":false,"description":"Fiscal year (e.g. 2025)","schema":{"type":"string"},"example":"2025"}],"responses":{"200":{"description":"Successful response (payment settled)","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request"},"402":{"description":"Payment required. Pay with x402 and retry.","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 PaymentRequired object","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found"}}}},"/v1/companies/risk-profile/batch":{"post":{"operationId":"companies_risk_profile_batch","summary":"Batch company risk profiles","description":"Screen up to 10 companies in one call. Returns a risk profile per corporate number, plus a not_found list.","tags":["companies","risk","compliance","batch"],"parameters":[],"requestBody":{"required":true,"description":"Corporate numbers to screen. 1-10 entries.","content":{"application/json":{"schema":{"type":"object","properties":{"corporate_numbers":{"type":"array","items":{"type":"string","pattern":"^\\d{13}$"},"minItems":1,"maxItems":10},"fiscal_year":{"type":"string"}},"required":["corporate_numbers"]},"example":{"corporate_numbers":["1180301018771","2011101083253"],"fiscal_year":"2025"}}}},"responses":{"200":{"description":"Successful response (payment settled)","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request"},"402":{"description":"Payment required. Pay with x402 and retry.","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 PaymentRequired object","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found"}}}},"/v1/companies/{corporate_number}/subsidy-matches":{"get":{"operationId":"companies_subsidy_matches","summary":"Match open subsidies to a company","description":"Return open subsidies that target the company's prefecture, with the company's basic profile.","tags":["companies","subsidies","grants","match"],"parameters":[{"name":"corporate_number","in":"path","required":true,"description":"13-digit Japanese corporate number","schema":{"type":"string","pattern":"^\\d{13}$"},"example":"1180301018771"},{"name":"limit","in":"query","required":false,"description":"1-20 (default 10)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response (payment settled)","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request"},"402":{"description":"Payment required. Pay with x402 and retry.","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 PaymentRequired object","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found"}}}},"/v1/companies/{corporate_number}/tender-opportunities":{"get":{"operationId":"companies_tender_opportunities","summary":"Find tenders for a company","description":"Return open public tenders in the company's prefecture, ordered by bid deadline where available.","tags":["companies","procurement","tenders","match"],"parameters":[{"name":"corporate_number","in":"path","required":true,"description":"13-digit Japanese corporate number","schema":{"type":"string","pattern":"^\\d{13}$"},"example":"1180301018771"},{"name":"limit","in":"query","required":false,"description":"1-20 (default 10)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response (payment settled)","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request"},"402":{"description":"Payment required. Pay with x402 and retry.","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 PaymentRequired object","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found"}}}},"/v1/sanctions/search":{"get":{"operationId":"sanctions_search","summary":"Search administrative sanctions","description":"Search curated administrative sanctions by keyword, authority, corporate number, and date range.","tags":["sanctions","compliance","search"],"parameters":[{"name":"q","in":"query","required":false,"description":"Keyword (company name, summary, type)","schema":{"type":"string"},"example":"措置命令"},{"name":"corporate_number","in":"query","required":false,"description":"13-digit corporate number","schema":{"type":"string"}},{"name":"authority","in":"query","required":false,"description":"Authority, e.g. 消費者庁","schema":{"type":"string"}},{"name":"date_from","in":"query","required":false,"description":"Date from (YYYY-MM-DD)","schema":{"type":"string"}},{"name":"date_to","in":"query","required":false,"description":"Date to (YYYY-MM-DD)","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"1-50 (default 20)","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"1-10 (default 1)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response (payment settled)","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request"},"402":{"description":"Payment required. Pay with x402 and retry.","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 PaymentRequired object","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found"}}}},"/v1/subsidies/search":{"get":{"operationId":"subsidies_search","summary":"Search Japanese subsidies","description":"Search subsidies by keyword, region, industry, purpose, and open status.","tags":["subsidies","grants"],"parameters":[{"name":"q","in":"query","required":false,"description":"Keyword","schema":{"type":"string"},"example":"DX"},{"name":"region","in":"query","required":false,"description":"Target region","schema":{"type":"string"},"example":"東京都"},{"name":"industry","in":"query","required":false,"description":"Target industry","schema":{"type":"string"},"example":"情報通信業"},{"name":"purpose","in":"query","required":false,"description":"Purpose","schema":{"type":"string"},"example":"設備投資"},{"name":"open_only","in":"query","required":false,"description":"true to return only open subsidies","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"1-50 (default 20)","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"1-10 (default 1)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response (payment settled)","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request"},"402":{"description":"Payment required. Pay with x402 and retry.","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 PaymentRequired object","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found"}}}},"/v1/subsidies/{id}":{"get":{"operationId":"subsidies_get","summary":"Get a Japanese subsidy","description":"Get subsidy details, eligibility, amount, and official URL.","tags":["subsidies","grants"],"parameters":[{"name":"id","in":"path","required":true,"description":"Resource identifier","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response (payment settled)","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request"},"402":{"description":"Payment required. Pay with x402 and retry.","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 PaymentRequired object","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found"}}}},"/v1/procurements/search":{"get":{"operationId":"procurements_search","summary":"Search Japanese public tenders","description":"Search open tenders from national and local governments.","tags":["procurement","tenders"],"parameters":[{"name":"q","in":"query","required":false,"description":"Keyword","schema":{"type":"string"},"example":"システム"},{"name":"agency","in":"query","required":false,"description":"Procuring agency","schema":{"type":"string"},"example":"デジタル庁"},{"name":"prefecture","in":"query","required":false,"description":"Prefecture","schema":{"type":"string"},"example":"東京都"},{"name":"category","in":"query","required":false,"description":"Category","schema":{"type":"string"},"example":"役務"},{"name":"date_from","in":"query","required":false,"description":"Published from (YYYY-MM-DD)","schema":{"type":"string"}},{"name":"date_to","in":"query","required":false,"description":"Published to (YYYY-MM-DD)","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"1-50 (default 20)","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"1-10 (default 1)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response (payment settled)","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request"},"402":{"description":"Payment required. Pay with x402 and retry.","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 PaymentRequired object","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found"}}}},"/v1/procurements/awards":{"get":{"operationId":"procurements_awards","summary":"Search Japanese contract awards","description":"Search national government contract awards by keyword or corporate number.","tags":["procurement","awards"],"parameters":[{"name":"q","in":"query","required":false,"description":"Keyword","schema":{"type":"string"},"example":"システム"},{"name":"corporate_number","in":"query","required":false,"description":"13-digit corporate number","schema":{"type":"string"}},{"name":"agency","in":"query","required":false,"description":"Procuring agency","schema":{"type":"string"}},{"name":"fiscal_year","in":"query","required":false,"description":"Fiscal year (e.g. 2025)","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"1-50 (default 20)","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"1-10 (default 1)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response (payment settled)","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request"},"402":{"description":"Payment required. Pay with x402 and retry.","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 PaymentRequired object","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found"}}}},"/v1/laws/search":{"get":{"operationId":"laws_search","summary":"Search Japanese laws","description":"Search laws and regulations via e-Gov, with an optional as-of date.","tags":["laws","regulation"],"parameters":[{"name":"q","in":"query","required":true,"description":"Keyword","schema":{"type":"string"},"example":"食品"},{"name":"law_type","in":"query","required":false,"description":"Law type","schema":{"type":"string"},"example":"法律"},{"name":"asof","in":"query","required":false,"description":"As-of date (YYYY-MM-DD)","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"1-50 (default 20)","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"1-10 (default 1)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response (payment settled)","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request"},"402":{"description":"Payment required. Pay with x402 and retry.","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 PaymentRequired object","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found"}}}},"/v1/laws/{law_id}":{"get":{"operationId":"laws_get","summary":"Get a Japanese law","description":"Get a law's structured text, articles, and revision metadata.","tags":["laws","regulation"],"parameters":[{"name":"law_id","in":"path","required":true,"description":"Resource identifier","schema":{"type":"string"}},{"name":"asof","in":"query","required":false,"description":"As-of date (YYYY-MM-DD)","schema":{"type":"string"}},{"name":"article","in":"query","required":false,"description":"Article number (e.g. 1)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response (payment settled)","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request"},"402":{"description":"Payment required. Pay with x402 and retry.","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 PaymentRequired object","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found"}}}}},"components":{"securitySchemes":{"x402":{"type":"apiKey","in":"header","name":"PAYMENT-SIGNATURE","description":"x402 payment payload (base64url-encoded JSON)."}}}}