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
String
required
The Voltage ID of the organization that you want to list nodes for.
Header Parameters
X-VOLTAGE-AUTH
String
required
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
String
required
The Voltage ID of the organization that owns the node.
node_id
String
required
The Voltage ID of the node that you want to get information for.
Header Parameters
X-VOLTAGE-AUTH
String
required
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
String
required
The Voltage ID of the organization that owns the node.
Header Parameters
X-VOLTAGE-AUTH
String
required
Your Voltage API Key that can be created on your Voltage Dashboard.
Body Parameters
name
String
required
User defined node name given at creation
network
String
required
Network the node is running on. Can be either 'testnet' or 'mainnet'.
type
String
required
Type of node, either 'standard' or 'professional'
settings
Object
required
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
String
required
The Voltage ID of the organization that owns the node.
node_id
String
required
The Voltage ID of the node that you want to backup a macaroon for.
Header Parameters
X-VOLTAGE-AUTH
String
required
Your Voltage API Key that can be created on your Voltage Dashboard.
Body Parameters
macaroon
String
required
Encrypted string of the macaroon. DO NOT UPLOAD UNENCRYPTED DATA.
name
String
required
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
String
required
The Voltage ID of the organization that you want to list nodes for.
node_id
String
required
The Voltage ID of the node that you want to backup a seed for.
Header Parameters
X-VOLTAGE-AUTH
String
required
Your Voltage API Key that can be created on your Voltage Dashboard.
Body Parameters
seed
String
required
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
String
required
The Voltage ID of the organization owns the node.
node_id
String
required
The Voltage ID of the node that you want to update the whitelist fo.
Header Parameters
X-VOLTAGE-AUTH
String
required
Your Voltage API Key that can be created on your Voltage Dashboard.
Body Parameters
whitelist
Array
required
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
String
required
The Voltage ID of the organization owns the node.
node_id
String
required
The Voltage ID of the node that you want to update the whitelist fo.
Header Parameters
X-VOLTAGE-AUTH
String
required
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
String
required
The Voltage ID of the organization owns the node.
node_id
String
required
The Voltage ID of the node that you want to update the whitelist fo.
Header Parameters
X-VOLTAGE-AUTH
String
required
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
String
required
The Voltage ID of the organization owns the node.
node_id
String
required
The Voltage ID of the node that you want to update the whitelist fo.
Header Parameters
X-VOLTAGE-AUTH
String
required
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
String
required
The Voltage ID of the organization owns the node.
node_id
String
required
The Voltage ID of the node that you want to update the whitelist fo.
Header Parameters
X-VOLTAGE-AUTH
String
required
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.
DELETE
Request
Path Params
organization_id
String
required
The Voltage ID of the organization owns the node.
node_id
String
required
The Voltage ID of the node that you want to update the whitelist fo.
Header Parameters
X-VOLTAGE-AUTH
String
required
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
String
required
The Voltage ID of the organization that owns the node.
node_id
String
required
The Voltage ID of the node that you want to update the whitelist fo.
Header Parameters
X-VOLTAGE-AUTH
String
required
Your Voltage API Key that can be created on your Voltage Dashboard.
Body Parameters
settings
Object
required
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
String
required
The Voltage ID of the organization that owns the node.
node_id
String
required
The Voltage ID of the node that you want to backup a macaroon for.
Header Parameters
X-VOLTAGE-AUTH
String
required
Your Voltage API Key that can be created on your Voltage Dashboard.
Curl
Node.js
JS
Python
Ruby
Responses
200
404