Skip to content
/bounty
Sign in
All bounties

e-Tax

Open
e-tax.nta.go.jp

Japanese tax workflows for filings, certificates, and status tracking on e-Tax.

Reward
₩500,000
Tier
Platinum
Auth
Browser
APIs
6 APIs
Working now
none
Posted
2026-07-07
Kind
New service
Lifecycle
  1. Open
  2. Claimed
  3. In review
  4. Finalizing
  5. Syncing
  6. Merged
  7. Paid

Scope

Build a high-trust Japanese tax workflow provider for e-Tax. It must handle My Number authentication boundaries, prepare tax filings, show all submission details, require explicit approval, and retrieve status or receipts without exposing sensitive data in logs.

Expected APIs

6
search-proceduresSearch government or tax proceduresReadHard

Search available tax procedures on e-Tax by keyword and category. This targets the authenticated browser surface, not a public REST API.

Inputs
  • keywordstringOptionalProcedure keywordExample final tax return
  • categorystringOptionalProcedure categoryExample tax
  • fiscal_yearstringOptionalTarget fiscal yearExample 2025
Outputs
procedure_idtitlecategoryagencyrequires_my_number_cardonline_available
Acceptance
  • Returns procedures matching the keyword or category from the authenticated portal.
  • Each procedure indicates whether a My Number card is required and if online submission is available.
  • Does not claim a public API; results come from the logged-in browser session.

Auth required for this API.

check-prerequisitesCheck identity and document prerequisitesReadHard

Check the identity, My Number card, e-certificate, and document prerequisites required to start a selected procedure.

Inputs
  • procedure_idstringRequiredProcedure identifierExample proc_final_return
Outputs
procedure_idrequired_documentscard_auth_requirede_cert_requiredprerequisite_status
Acceptance
  • Returns the required documents and authentication level for the procedure.
  • Flags whether card-based authentication or an e-certificate is mandatory.
  • Reports prerequisite_status so the user knows if they can proceed.

Auth required for this API.

prepare-filingPrepare benefit, certificate, or tax filingWriteHard

Assemble a benefit application, certificate request, or tax filing draft with the collected inputs for review. This prepares but does not submit the request.

Inputs
  • procedure_idstringRequiredProcedure identifierExample proc_final_return
  • form_dataobjectRequiredCollected form field valuesExample {"income":5200000}
  • attachmentsarrayOptionalReferences to prepared attachmentsExample ["withholding_slip"]
Outputs
draft_idprocedure_idvalidation_warningsrequires_confirmation
Acceptance
  • Produces a filing draft with any validation_warnings and requires_confirmation true.
  • Does not submit to the agency; only a reviewable draft is returned.
  • Missing mandatory formData fields are surfaced as validation warnings.

Auth required for this API.

submit-requestSubmit an approved requestWriteHard

Submit a prepared draft to the government or tax authority, executed only after explicit user confirmation through the authenticated session.

Inputs
  • draft_idstringRequiredPrepared draft idExample drft_final_2025
  • confirmationbooleanRequiredExplicit user confirmation flagExample true
Outputs
submission_idstatusaccepted_atreceipt_number
Acceptance
  • Submits only when confirmation is true and a valid draftId exists.
  • Returns a submission_id and receipt_number issued by the authority.
  • A draft failing prerequisite checks is not submitted.

Auth required for this API.

get-statusGet application, filing, or payment statusReadHard

Retrieve the current status of a submitted application, tax filing, or payment from the portal.

Inputs
  • submission_idstringRequiredSubmission identifierExample sub_88213
Outputs
submission_idstatusstatus_updated_atpayment_statusnext_action
Acceptance
  • Returns the current status and last update time for the submission_id.
  • Includes payment_status when the procedure involves a payment.
  • An unknown submission_id returns an explicit not-found result.

Auth required for this API.

download-documentsDownload receipts, notices, or issued documentsReadHard

Download issued receipts, notices, or certificates produced by a completed procedure through the authenticated session.

Inputs
  • submission_idstringRequiredSubmission identifierExample sub_88213
  • document_typestringOptionalDocument type to downloadExample receipt
Outputs
document_iddocument_typedownload_urlissued_at
Acceptance
  • Returns downloadable document references only for the authenticated user's completed procedures.
  • Distinguishes receipts, notices, and issued certificates via document_type.
  • Documents not yet issued return a pending state rather than a broken link.

Auth required for this API.

Suggested surface. Propose changes in your submission if the upstream differs.

Acceptance criteria

  • Service scaffolded from the public @apifuse/provider-sdk
  • All listed APIs implemented with Zod/Standard Schema input & output
  • Each API 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
  • API list with input/output summaries
  • healthCheck coverage table per API
  • bun run check and bun run test output

Ready to claim?

Submit a claim. Your workspace is prepared after confirmation.