Skip to content
/bounty
Sign in
All bounties

Myna Portal

Open
myna.go.jp

Japanese government workflows for benefits, applications, certificates, and status tracking on Myna Portal.

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 government workflow provider for Myna Portal. It must handle My Number authentication boundaries, prepare administrative actions, 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 administrative and tax procedures on My Number Portal (Mynaportal) 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.