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

Parameter	Type	Required	Description	Example
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

200

Metadata

Field	Type	Description	Example
after	string	Cursor for next page of results.	"q1w2e3r4t5...z0" (opaque token)
total_count	integer	Total number of entries available.	142

Entry Fields

Field	Type	Description	Example
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"
      }
    ]
  }
}

400

401