# Japan Data API

Agent-first Japanese public data API. No account or API key is required for paid calls.
Paid endpoints return HTTP 402 with x402 payment requirements. Pay in USDC (Base) or JPYC (Polygon) and retry.

Base URL: https://japan-data-api-x402.fly.dev
Discovery: https://japan-data-api-x402.fly.dev/.well-known/x402
OpenAPI: https://japan-data-api-x402.fly.dev/openapi.json
MCP: https://japan-data-api-x402.fly.dev/mcp
Pricing: https://japan-data-api-x402.fly.dev/pricing

## Free

- GET /v1/public/companies/:corporate_number/basic — free teaser (registry basics only)
- GET /v1/plans — plans and payment info
- GET /v1/meta — data source status

## Flagship bundle

- GET /v1/companies/:corporate_number/risk-profile — $0.20
  Registry + financials + sanctions + matching subsidies + tenders + awards + heuristic risk score.
  The risk score is a screening heuristic, not a credit rating or legal opinion.

## Paid endpoints

- GET /v1/companies/search — $0.02 / 3 JPYC
  Search Japanese companies
  Source: 国税庁 法人番号システム Web-API
- GET /v1/companies/:corporate_number — $0.02 / 3 JPYC
  Get a Japanese company
  Source: 国税庁 法人番号システム Web-API
- GET /v1/companies/:corporate_number/financials — $0.10 / 15 JPYC
  Get company financials
  Source: 金融庁 EDINET API v2
- GET /v1/companies/:corporate_number/sanctions — $0.05 / 8 JPYC
  Get company sanctions
  Source: 省庁公表資料（キュレーション）
- GET /v1/companies/:corporate_number/risk-profile — $0.20 / 30 JPYC
  Get a company risk profile
  Source: 複数ソース統合（法人番号 / gBizINFO / Jグランツ / 官公需 / 調達ポータル / 行政処分）
- POST /v1/companies/risk-profile/batch — $0.50 / 75 JPYC
  Batch company risk profiles
  Source: 複数ソース統合（法人番号 / gBizINFO / Jグランツ / 官公需 / 調達ポータル / 行政処分）
- GET /v1/companies/:corporate_number/subsidy-matches — $0.10 / 15 JPYC
  Match open subsidies to a company
  Source: 国税庁 法人番号 / gBizINFO / デジタル庁 Jグランツ
- GET /v1/companies/:corporate_number/tender-opportunities — $0.10 / 15 JPYC
  Find tenders for a company
  Source: 国税庁 法人番号 / gBizINFO / 中小企業庁 官公需情報ポータル
- GET /v1/sanctions/search — $0.05 / 8 JPYC
  Search administrative sanctions
  Source: 金融庁・消費者庁 公表資料（キュレーション）
- GET /v1/subsidies/search — $0.03 / 5 JPYC
  Search Japanese subsidies
  Source: デジタル庁 Jグランツ API
- GET /v1/subsidies/:id — $0.05 / 8 JPYC
  Get a Japanese subsidy
  Source: デジタル庁 Jグランツ API
- GET /v1/procurements/search — $0.03 / 5 JPYC
  Search Japanese public tenders
  Source: 中小企業庁 官公需情報ポータルサイト API
- GET /v1/procurements/awards — $0.05 / 8 JPYC
  Search Japanese contract awards
  Source: デジタル庁 調達ポータル 落札実績オープンデータ
- GET /v1/laws/search — $0.02 / 3 JPYC
  Search Japanese laws
  Source: e-Gov 法令API v2
- GET /v1/laws/:law_id — $0.03 / 5 JPYC
  Get a Japanese law
  Source: e-Gov 法令API v2

## Attribution

このサービスは、国税庁法人番号システムWeb-API機能を利用して取得した情報をもとに作成しているが、サービスの内容は国税庁によって保証されたものではない

## Example

```bash
curl -i https://japan-data-api-x402.fly.dev/v1/companies/search?q=サンプル
# -> 402 with PAYMENT-REQUIRED
# Pay with an x402 client, then retry with PAYMENT-SIGNATURE.
```

## Demo mode

In local mock mode, send `X-Mock-Paid: true` to simulate a settled payment.