What is kurnl?
kurnl is an open access internet platform. It manages shared network infrastructure — switches, buildings, and subscriber ports — and provides a multi-ISP marketplace where subscribers choose and sign up for internet service. As a provider (ISP), you list your plans on the kurnl marketplace, manage your subscribers, and connect your checkout or back-office system to kurnl’s provisioning layer via API.What you can build
External Checkout (CKO-03)
Subscriber picks your plan on the kurnl marketplace, completes payment on your own checkout page, and you call one API endpoint. kurnl handles subscriber creation, subscription, and port provisioning.
Provider-Initiated (CKO-04)
Provision subscribers directly from your own system — no Stripe, no marketplace redirect. One API call creates the subscriber, subscription, and activates the port.
Subscriber Management
Create, update, and cancel subscribers and subscriptions programmatically. Query subscriber status, change plans, and manage the full lifecycle via API.
Bulk Provisioning
Provision up to 100 subscribers in a single batch call. Poll for batch status and handle partial failures gracefully.
How the platform works
kurnl sits between the physical network and your subscriber-facing system. When a subscriber signs up, kurnl:- Creates a subscriber record and subscription in the database
- Looks up the switch port assigned to that subscriber’s location
- Configures the port via SSH — sets the VLAN, applies bandwidth limits, and optionally binds the subscriber’s MAC address
- Fires webhook events to your system at each stage
Authentication
kurnl uses two authentication mechanisms depending on the integration type:| Method | Header | Used for |
|---|---|---|
| API Key | X-API-Key | Subscriber management, bulk provisioning, plan queries |
| Webhook Secret | X-Webhook-Secret | CKO-03 external checkout callbacks |
The sandbox uses separate credentials from production. See Sandbox Setup for details.