Developer Resources
API Resources

Voltage API

10min

Voltage has an API that you can use to manage your nodes. With this API you can create, stop, start, update your node. All the functionality that you see in our dashboard can be accomplished with the Voltage API. With our API, you can greatly extend the capabilities for the Voltage platform. For example, you can create nodes for your users directly in your own sites.

Base URL

https://api.voltage.cloud



Currently you must use HTTP 1.1 with this API. It does not suport HTTP 2.0

Authentication

To generate an API Key, navigate to your Team's home page. The menu on the left side will have an 'API' section. Expand that and click 'Keys'. Click the 'New Key' button and generate a new API Key. Give it a name and be sure to save the key as it will not be displayed again.

Once you have an API Key, you can use it in your API Requests with the X-VOLTAGE-AUTH header. All API Endpoints require authentication.

Endpoints

Get a list of nodes owned by an organization.
GET
Request
Path Params
organization_id
required
String
The Voltage ID of the organization that you want to list nodes for.
Header Parameters
X-VOLTAGE-AUTH
required
String
Your Voltage API Key that can be created on your Voltage Dashboard.
Curl
Node.js
JS
Python
Ruby
Responses
200
404

Get information about a specific node.
GET
Request
Path Params
organization_id
required
String
The Voltage ID of the organization that owns the node.
node_id
required
String
The Voltage ID of the node that you want to get information for.
Header Parameters
X-VOLTAGE-AUTH
required
String
Your Voltage API Key that can be created on your Voltage Dashboard.
Curl
Node.js
JS
Python
Ruby
Responses
200
404

Create a new Lightning node.
POST
Request
Path Params
organization_id
required
String
The Voltage ID of the organization that owns the node.
Header Parameters
X-VOLTAGE-AUTH
required
String
Your Voltage API Key that can be created on your Voltage Dashboard.
Body Parameters
name
required
String
User defined node name given at creation
network
required
String
Network the node is running on. Can be either 'testnet' or 'mainnet'.
type
required
String
Type of node, either 'standard' or 'professional'
settings
required
Object
Settings for the Lightning Node
Curl
Node.js
JS
Python
Ruby
Responses
200
404

Upload an encrypted macaroon for a node for backup and dashboard functionality.
POST
Request
Path Params
organization_id
required
String
The Voltage ID of the organization that owns the node.
node_id
required
String
The Voltage ID of the node that you want to backup a macaroon for.
Header Parameters
X-VOLTAGE-AUTH
required
String
Your Voltage API Key that can be created on your Voltage Dashboard.
Body Parameters
macaroon
required
String
Encrypted string of the macaroon. DO NOT UPLOAD UNENCRYPTED DATA.
name
required
String
Name of the macaroon you're backing up.
Curl
Node.js
JS
Python
Ruby
Responses
200
404

Upload an encrypted seed phrase for a node for backup.
POST
Request
Path Params
organization_id
required
String
The Voltage ID of the organization that you want to list nodes for.
node_id
required
String
The Voltage ID of the node that you want to backup a seed for.
Header Parameters
X-VOLTAGE-AUTH
required
String
Your Voltage API Key that can be created on your Voltage Dashboard.
Body Parameters
seed
required
String
Encrypted string of the seed. DO NOT UPLOAD UNENCRYPTED DATA.
Curl
Node.js
JS
Python
Ruby
Responses
200
404

Update the IP Addresses that are allowed to talk to a node's APIs
POST
Request
Path Params
organization_id
required
String
The Voltage ID of the organization owns the node.
node_id
required
String
The Voltage ID of the node that you want to update the whitelist fo.
Header Parameters
X-VOLTAGE-AUTH
required
String
Your Voltage API Key that can be created on your Voltage Dashboard.
Body Parameters
whitelist
required
Array
List of IP Addresses that are allowed to talk to your node
Curl
Node.js
JS
Python
Ruby
Responses
200
404

Get the TLS Certificate for a Node.
GET
Request
Path Params
organization_id
required
String
The Voltage ID of the organization owns the node.
node_id
required
String
The Voltage ID of the node that you want to update the whitelist fo.
Header Parameters
X-VOLTAGE-AUTH
required
String
Your Voltage API Key that can be created on your Voltage Dashboard.
Curl
Node.js
JS
Python
Ruby
Responses
200
404

Start up a Node.
POST
Request
Path Params
organization_id
required
String
The Voltage ID of the organization owns the node.
node_id
required
String
The Voltage ID of the node that you want to update the whitelist fo.
Header Parameters
X-VOLTAGE-AUTH
required
String
Your Voltage API Key that can be created on your Voltage Dashboard.
Curl
Node.js
JS
Python
Ruby
Responses
200
404

Shut down a Node.
POST
Request
Path Params
organization_id
required
String
The Voltage ID of the organization owns the node.
node_id
required
String
The Voltage ID of the node that you want to update the whitelist fo.
Header Parameters
X-VOLTAGE-AUTH
required
String
Your Voltage API Key that can be created on your Voltage Dashboard.
Curl
Node.js
JS
Python
Ruby
Responses
200
404

Update a Node to the latest version.
PUT
Request
Path Params
organization_id
required
String
The Voltage ID of the organization owns the node.
node_id
required
String
The Voltage ID of the node that you want to update the whitelist fo.
Header Parameters
X-VOLTAGE-AUTH
required
String
Your Voltage API Key that can be created on your Voltage Dashboard.
Curl
Node.js
JS
Python
Ruby
Responses
200
404

Delete a Node from team.
POST
Request
Path Params
organization_id
required
String
The Voltage ID of the organization owns the node.
node_id
required
String
The Voltage ID of the node that you want to update the whitelist fo.
Header Parameters
X-VOLTAGE-AUTH
required
String
Your Voltage API Key that can be created on your Voltage Dashboard.
Curl
Node.js
JS
Python
Ruby
Responses
200
404




Update a node's settings.
PUT
Request
Path Params
organization_id
required
String
The Voltage ID of the organization that owns the node.
node_id
required
String
The Voltage ID of the node that you want to update the whitelist fo.
Header Parameters
X-VOLTAGE-AUTH
required
String
Your Voltage API Key that can be created on your Voltage Dashboard.
Body Parameters
settings
required
Object
Settings for the Lightning Node
Curl
Node.js
JS
Python
Ruby
Responses
200
404

Upload a macaroon for the Voltage Support team to use.
POST
Request
Path Params
organization_id
required
String
The Voltage ID of the organization that owns the node.
node_id
required
String
The Voltage ID of the node that you want to backup a macaroon for.
Header Parameters
X-VOLTAGE-AUTH
required
String
Your Voltage API Key that can be created on your Voltage Dashboard.
Curl
Node.js
JS
Python
Ruby
Responses
200
404