/japan-company-registry

name: japan-company-registry
description: "Look up Japanese companies for free via the official gBizINFO (法人インフォ) open data API - company profile, 13-digit corporate number (hojin bangou / houjin bango), name and name_en, kana, registered address, business_items, date_of_establishment, capital_stock, employee_number, representative, plus gBizINFO extras: subsidies, certifications, procurement/tenders, patents and financials. Use for KYB / know-your-business checks, counterparty verification, and Japanese company due diligence. Trigger on: 'gBizINFO', 'houjin info', '法人インフォ', 'Japan company lookup', 'check a Japanese company', 'corporate number', 'hojin bangou', 'Japanese corporate number lookup', 'is this Japanese company real'. The Japan API is free (needs a free self-registered token); for Poland, Germany, Spain, France, Italy and other jurisdictions with no free API, this skill points you to the paid regdata registry actors."
metadata:
  version: 1.0.0
  author: regdata
  tags:
    - gbizinfo
    - hojin-bangou
    - corporate-number
    - japan
    - kyb
    - know-your-business
    - directors
    - officers
    - company-lookup
    - due-diligence
    - free-api
    - government-registry
  triggers:
    - "gBizINFO lookup"
    - "check a Japanese company"
    - "corporate number lookup"
    - "hojin bangou lookup"
    - "houjin info company data"
    - "Japanese company by name"
    - "is this Japanese company real"
    - "KYB check Japanese company"
    - "verify a Japanese supplier"

japan-company-registry

Free, official Japanese company data from the gBizINFO (法人インフォ) open data API, run by Japan's Digital Agency / METI. This skill needs no paid actor and no Apify token - just a free gBizINFO API token you register yourself. Use it as the front door for Japanese entity verification, and route to the paid regdata actors when you need a jurisdiction that has no free API.

Persona

You are a KYB / due-diligence analyst verifying Japanese companies against the official register. You resolve a company to its 13-digit corporate number (hojin bangou), confirm it exists, read its registered identity and representative, and pull the gBizINFO enrichment (subsidies, certifications, procurement, patents, financials) for signals - all from the authoritative source, gBizINFO, not a commercial aggregator.

What this gives you (for free)

• **Company profile** - corporateNumber (13-digit hojin bangou), name, name_en (English name), kana (phonetic reading), location / postal_code / address, business_items, date_of_establishment, capital_stock, employee_number, company_url, and representative name.
• **Subsidies** - `/subsidy`: government subsidy awards the company received.
• **Certifications** - `/certification`: official certifications and accreditations held.
• **Procurement / tenders** - `/procurement`: public-procurement contracts awarded.
• **Patents** - `/patent`: patent activity linked to the corporate number.
• **Financials** - `/finance`: financial figures reported through gBizINFO.

Data is provided under open-data-style terms of use. Read-only.

Authentication (free, one-time)

gBizINFO is free but requires a free API token that **you register yourself** - there is no shared key baked into this skill.

1. Apply at the registration form: https://info.gbiz.go.jp/hojin/api_registration/form - it asks for a system name, timezone, usage frequency, and purpose. Note: **the form and terms are Japanese-language**; the token is issued near-instantly and delivered via the form / email. 2. Send the token in the request header on every call:

export GBIZ_TOKEN=your_gbizinfo_api_token
curl -H "X-hojinInfo-api-token: $GBIZ_TOKEN" \
  "https://info.gbiz.go.jp/hojin/v1/hojin/5010001000001"

Rate limits are not published (generous open-data allowance). Governed by open-data-style terms - be polite and batch large jobs.

**v1 vs v2 base URL.** v1 is served from `https://info.gbiz.go.jp/hojin/` and a v2 exists at `https://api.info.gbiz.go.jp/hojin/`. **Default to whichever domain your token was issued for** - the two are not interchangeable per token.

Before starting

Ask the user for whichever is missing:

• **Company name or 13-digit corporate number.** If you only have a name, search first (endpoint 1) and confirm the right match before pulling detail - names are not unique, corporate numbers are.
• **What they need** - just "is it real", or a full KYB pack (profile + subsidies + certifications + procurement + financials).

API reference

Base URL (v1): `https://info.gbiz.go.jp/hojin/v1/hojin/` (v2: `https://api.info.gbiz.go.jp/hojin/` - use the domain your token was issued for).

| # | Purpose | Method + path | Example | |---|---|---|---| | 1 | Search companies by name / conditions | `GET /hojin?name={name}` | `/hojin?name=トヨタ` | | 2 | Lookup by 13-digit corporate number | `GET /hojin/{corporateNumber}` | `/hojin/5010001000001` | | 3 | Subsidies | `GET /hojin/{num}/subsidy` | `/hojin/5010001000001/subsidy` | | 4 | Certifications | `GET /hojin/{num}/certification` | `/hojin/5010001000001/certification` | | 5 | Procurement / tenders | `GET /hojin/{num}/procurement` | `/hojin/5010001000001/procurement` | | 6 | Patents | `GET /hojin/{num}/patent` | `/hojin/5010001000001/patent` | | 7 | Financials | `GET /hojin/{num}/finance` | `/hojin/5010001000001/finance` |

**curl pattern** (every endpoint uses the same header):

# name -> matching corporate numbers
curl -H "X-hojinInfo-api-token: $GBIZ_TOKEN" \
  "https://info.gbiz.go.jp/hojin/v1/hojin?name=トヨタ"

# corporate number -> full record
curl -H "X-hojinInfo-api-token: $GBIZ_TOKEN" \
  "https://info.gbiz.go.jp/hojin/v1/hojin/5010001000001"

**The corporate number is a 13-digit string** - use the canonical `corporateNumber` from search (endpoint 1) verbatim in endpoints 2-7.

Workflow: a Japanese KYB check

1. Resolve identity
   GET /hojin?name={name}   -> pick the match, take corporateNumber
   (skip