LifestylePlatform secret

Japan Corporate Number

houjin-bangou.nta.go.jp

Japan National Tax Agency corporate number data provider.

Tier: 🥉 Bronze
Reward: ₩15,000
Auth: Platform secret
Operations: 2
Working now: 0 contributors
Status: Open

Scope

Exposes the Japan National Tax Agency corporate number registry. Callers search corporations by name and read the published record for a corporate number, including registered name and address.

Expected operations

search-corporationsSearch corporationsreadDifficulty: easy

Return corporations matching a trade name, with corporate numbers and prefecture-level location.

Inputs

namestringrequired

Suggested surface — propose changes in your submission if the upstream differs.

Acceptance criteria

Provider scaffolded from the public @apifuse/provider-sdk
All listed operations implemented with Zod/Standard Schema input & output
Each operation declares exactly one of healthCheck or healthCheckUnsupported
Real upstream fixture data included where applicable
bun run check and bun run test pass
Auth, credential, and env-secret behavior documented (no real secrets committed)

Evidence to submit

Workspace repository and main commit link
SDK version/tag and the create command used
Operation list with input/output summaries
Health coverage table per operation
bun run check and bun run test output

Ready to claim?

Submit a claim. Your workspace will be prepared after confirmation.

Claiming a bounty requires a GitHub sign-in.

Corporate trade name to search

prefecture_codestringoptional

Two-digit prefecture code to scope the search

limitnumberoptional

Maximum number of corporations to return

Outputs

corporationscorporate_numbernameprefecturecityregistered_ontotal_count

Acceptance

Corporate numbers are the thirteen-digit national identifiers accepted directly by the detail operation.
Closed corporations remain searchable with their status rather than being filtered out silently.

Auth required for this operation.

get-corporation-detailGet corporation detailreadDifficulty: easy

Return the published record for one corporate number, including registered name, full address, and change history flags.

Inputs

corporate_numberstringrequired
Thirteen-digit corporate number
1180301018771

Outputs

corporate_numbernamename_kanapostal_codeaddresscorporation_type

Acceptance

The closed flag and its date are explicit fields so lifecycle status is unambiguous.
A corporate number with no published record returns a not-found error rather than an empty object.

Auth required for this operation.