# 🚀 Introducing the TunnelSats Public API v1

We're excited to announce the official launch of the TunnelSats Public API - a complete programmatic interface for managing Bitcoin VPN subscriptions without touching a browser.


## What's New?
Our API provides full lifecycle management for WireGuard VPN subscriptions:
- ✅ **Create subscriptions** with Bitcoin Lightning payments
- ✅ **Renew automatically** using Nostr Wallet Connect (NWC)
- ✅ **Monitor data usage** and bandwidth limits
- ✅ **List active subscriptions** across all your configs
- ✅ **Sync WireGuard keys** to your server infrastructure

All endpoints return machine-readable JSON, support API key authentication, and respect rate limiting for fair usage.

## Why We Built This
We saw node runners and Bitcoin enthusiasts managing VPN subscriptions manually—copy-pasting config files, setting calendar reminders for renewals, and juggling multiple services. That's not sovereign.
:::highlight orange 📌
Privacy and automation shouldn't conflict.
:::

With this API, you can:
- Automate renewals via NWC and cron jobs
- Integrate VPN provisioning into node management UIs
- Build privacy-first tools on top of Bitcoin infrastructure
- Run headless setups without ever opening a web browser

## Who Should Use This?
### Node Operating Systems
**RaspiBlitz, Umbrel, MyNode, Start9, and others**: We'd love to collaborate on app store integrations. Imagine one-click VPN provisioning for your users, paid in sats, with zero personal data collection.

## Node Runners & Developers
If you're building:
- Lightning node automation tools
- Privacy-focused applications
- Bitcoin circular economy services
- WireGuard management dashboards

...this API is for you.

## What We Need From You
🛠️ Feedback: What's missing? What's clunky? Tell us.
🔌 Integrations: Share your use cases and let's build together.
⭐ Stars: If you find this useful, spread the word in the Bitcoin community.

## Get Started
📖 Documentation: [API reference](https://api.tunnelsats.com)
🔑 API Keys: Generate yours at [tunnelsats.com/dashboard](tunnelsats.com/dashboard)
But you can already lean in:
💬 Community: Join [our Telegram](https://tunnelsats.com/join-telegram) to discuss integrations

## The Vision
We're building infrastructure for a Bitcoin-native internet—where privacy, Lightning payments, and open APIs are default, not opt-in.
If you're working on node software, privacy tools, or Lightning integrations, let's talk. We're open to partnerships, co-development, and community-driven features.


:::highlight green 📌
**Need Code Examples?** > Stuck on a specific flow? We are happy to provide example scripts (**Python, Go, Node.js**) to help you get your automation logic running in minutes.
:::


### What We Are Looking For:
* **Programmatic Growth:** We are looking for partners to help grow VPN infrastructure for Lightning Node runners. If you are building a Node OS or a management dashboard, let’s talk about deep integrations.
* **Use-Cases & Feedback:** Whether you are building an auto-renewal bot via **NWC** or a headless server provisioning tool, we want to hear your story. Your feedback directly shapes our v2 roadmap.

:::tip[]
🕊️ Transparency: Check our [warrant canary](https://tunnelsats.com/transparency) - we've received zero government requests for user data.
:::



<p align="center">
  <b>⚡ Built for Bitcoiners. Powered by Lightning. Programmatic by Default.</b>
</p>