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

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"
      }
    ]
  }
}

Last updated