ev-subsidy-status

Run the status command with your region, vehicle type, and year, for example npx ev-subsidy-status status --region "경기 성남시" --vehicle passenger. It returns announcement, application, delivery, and remaining counts plus the official status label.

It supports passenger cars, cargo vehicles, and buses, matching the official portal's vehicle type categories. The default is passenger, and the year defaults to the current year in Asia/Seoul timezone.

No. The official ev.or.kr payment status page is public, so the default direct HTTP path needs no login, API key, browser, or proxy. A browser session is only an optional fallback for diagnosing page structure changes.

Official remarks take priority over numbers. If the region's note says closed, sold out, or application ended, the status is reported as closed even when the remaining delivery count is positive, because those counts can lag actual availability.

Yes, pass a model name to get an approximate KRW figure computed as remaining delivery count times that model's national plus local subsidy. It is an estimate only, not the region's exact remaining budget.

Ambiguous names like Jung-gu or Gangseo-gu trigger a candidate list from the regions command, and you pick the correct province. The tool never guesses between duplicate district names on its own.