Partner Nodes
Request
Retrieve a paginated list of all nodes registered by a specific partner. This endpoint returns detailed metadata for each node, including IP address, uptime duration, total data shared, and earnings contribution. It is typically used for partner-level monitoring, diagnostics, or earnings breakdown across individual nodes.
Endpoint
GET /api/v1/partner/nodes
URL:
https://stats.api.datagram.network/api/v1/partner/nodes
Query Parameters
secret
string
✅ Yes
Unique secret token identifying partner.
"pt_sec_abc123XYZ!*"
partner_node_id
string
❌ No
External ID of the partner node.
"partner_uk_prod_789"
after
string
❌ No
Cursor for pagination.
"eyJ...30="
Authentication
Authorization: Bearer <organization-token>
Example Request (Python)
GET /api/v1/partner/detail?secret=<partner-secret> HTTP/1.1
Host: stats.api.datagram.network
Authorization: <organization token>
Responses
Metadata
after
string
Cursor for next page of results.
"q1w2e3r4t5...z0"
(opaque token)
total_count
integer
Total number of entries available.
142
Entry Fields
ip
string
IP address of the node.
"203.0.113.42"
external_id
string
External ID of the node.
"ext_node_uk_prod_789"
time_connected
integer
Uptime in milliseconds.
86400000
(24 hours)
unit_shared
string
Shared data units.
"223"
usd_earned
string
Total earned amount in USD.
"1482.75"
public_id
string
Public identifier of the node.
"node_WX-5B3-2024"
public_name
string
Display the name of the node.
"London Backup Node"
connection_status
string
Connection status (e.g., "connected").
"connected"
Example:
{
"data": {
"metadata": {
"after": null,
"total_count": 1
},
"entries": [
{
"ip": "192.158.226.25",
"external_id": "external_id",
"time_connected": 5971237,
"unit_shared": "223",
"usd_earned": "9.9",
"public_id": "DTsXQgia6JistxIzbUVZrcWZokVIcZp/379qcP5MmSQ=",
"public_name": "Moaning-Katheryn-541",
"connection_status": "connected"
}
]
}
}
Last updated