netcup voucher CLI

A small, read-only command-line program for querying available netcup product voucher codes.

Prefer a browser? Browse the current netcup Gutschein finder and live voucher catalog.

The program sends one HTTPS GET request to the configured voucher API, validates the response, and prints product-to-code pairs. The default data source keeps each complete response unchanged for one hour. It contains no web crawler, scraper, account login, data writer, database client, or deployment tooling.

This is an independent community project and is not affiliated with netcup. Voucher codes are one-time use and can become unavailable at any moment.

Current voucher codes

This table is refreshed automatically every six hours from the same one-hour cached data source used by the CLI. Codes are one-time use and may become unavailable between refreshes. The timestamp changes only when the code list changes, so routine checks do not create no-op commits. Failed or expired API responses fail the action instead of being presented as newly verified data. The action only reads the cached feed; it never logs into CCP or generates codes. The current catalog keeps G12.5 and NUE identities separate from retired variants.

Last code update: 2026-11-10 07:30 UTC

Product	Available voucher codes
RS 1000 G12.5 root-1000-g12-5	6874nc17937882710 6874nc17938286770 6874nc17938389600 6874nc17939860110 6874nc17940448290 6874nc17942882910
RS 2000 G12.5 root-2000-g12-5	6875nc17937508090 6875nc17940172270 6875nc17940172272 6875nc17940754310 6875nc17940754311 6875nc17942202080
RS 8000 G12.5 root-8000-g12-5	6876nc17927671590 6876nc17927725100 6876nc17927725101 6876nc17927725102 6876nc17927725103 6876nc17934577610
VPS 1000 G12.5 vps-1000-g12-5	6877nc17936354310 6877nc17939169090 6877nc17939292400 6877nc17939601810 6877nc17940856320 6877nc17941360340
VPS 2000 G12.5 vps-2000-g12-5	6878nc17927725101 6878nc17930202810 6878nc17930214850 6878nc17930623190 6878nc17933498680 6878nc17936354320
VPS 4000 G12.5 vps-4000-g12-5	6879nc17927671590 6879nc17927725101 6879nc17927725102 6879nc17927725103 6879nc17927725104 6879nc17930202810
VPS 8000 G12.5 vps-8000-g12-5	6880nc17927671600 6880nc17927725101 6880nc17927725102 6880nc17927725103 6880nc17927725104 6880nc17930214850
Webhosting 2000 NUE webhosting-2000-nue	5207nc17927668910 5207nc17927668911 5207nc17927668912 5207nc17927668913 5207nc17927668914 5207nc17927668915
Webhosting 4000 NUE webhosting-4000-nue	5208nc17927668911 5208nc17927668912 5208nc17927668913 5208nc17927668914 5208nc17938259080 5208nc17938969880
Webhosting 8000 NUE webhosting-8000-nue	5209nc17927668910 5209nc17927668911 5209nc17927668912 5209nc17927668913 5209nc17927668914 5209nc17927668915
Webhosting 2000 NUE 1M webhosting-2000-nue-1m	6920nc17931725440 6920nc17931725441 6920nc17931725442

Requirements

• Bun 1.2 or newer

The npm package still uses Bun as its runtime.

Install

bun add --global netcup

Installing through npm also works when Bun is already installed:

npm install --global netcup

Usage

Show help without installing the package globally:

bunx netcup

List the supported product catalog without querying the voucher API:

bunx netcup list
bunx netcup list --json

List every supported product and its currently available codes:

bunx netcup --all

Filter by a full or partial product name. Broad queries return every matching product, so root returns all supported Root Servers:

bunx netcup root
bunx netcup vps-1000-g12-5
bunx netcup "RS 1000 G12.5"

Use JSON output:

bunx netcup vps-1000-g12-5 --json

Run bunx netcup --help for all options. If installed globally, omit bunx.

The default source is https://netcupgutschein.com/api/cli/vouchers. Its complete voucher snapshot is cached server-side for one hour. A different HTTPS endpoint with the same public JSON shape can be supplied using "--source " or "NETCUP_VOUCHER_SOURCE".

Development

git clone https://github.com/philipp-schuetz/netcup.git
cd netcup
bun install
bun run check
bun run release:check

Maintainers should follow PUBLISHING.md for the initial npm release and token-free GitHub trusted publishing setup.

License

MIT

The webhosting-2000-nue-1m product is the one-month minimum-term, monthly-billed NUE offer (CCP type 6920), separate from the existing webhosting-2000-nue twelve-month offer (5207). Its official €2.82/month German VAT-inclusive price already includes the ongoing 30% discount. The shared inventory keeps three monthly codes and six per existing product; README refreshes still run every six hours without contacting CCP.