LifestyleBrowser

Myna Portal

myna.go.jp

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

Tier: 💎 Platinum
Reward: ₩500,000
Auth: Browser
Operations: 6
Working now: 0 contributors
Status: Open

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 operations

search-proceduresSearch government or tax proceduresreadDifficulty: hard

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

keywordstringoptional

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.

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 operation.

check-prerequisitesCheck identity and document prerequisitesreadDifficulty: hard

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

Inputs

procedure_idstringrequired
Procedure identifier
proc_final_return

Outputs

procedure_idrequired_documentscard_auth_requirede_cert_requiredprerequisite_status

Acceptance

Returns the required documents and authentication level for the procedure.

prepare-filingPrepare benefit, certificate, or tax filingwriteDifficulty: hard

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_idstringrequired
Procedure identifier
proc_final_return
form_dataobjectrequired
Collected form field values
{"income":5200000}
attachmentsarrayoptional
References to prepared attachments
["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.

submit-requestSubmit an approved requestwriteDifficulty: hard

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

Inputs

draft_idstringrequired
Prepared draft id
drft_final_2025
confirmationbooleanrequired
Explicit user confirmation flag
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.

get-statusGet application, filing, or payment statusreadDifficulty: hard

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

Inputs

submission_idstringrequired
Submission identifier
sub_88213

Outputs

submission_idstatusstatus_updated_atpayment_statusnext_action

Acceptance

Returns the current status and last update time for the submission_id.

download-documentsDownload receipts, notices, or issued documentsreadDifficulty: hard

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

Inputs

submission_idstringrequired
Submission identifier
sub_88213
document_typestringoptional
Document type to download
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.