Partner Detail

Request

Retrieve detailed metadata about a specific partner's participation in the network. This endpoint provides insights into the partner’s current operational status, including the number of active nodes, connection duration, amount of data shared, and total earnings. It is typically used to monitor partner engagement and performance across the network.

Endpoint

GET /api/v1/partner/detail

URL:

https://stats.api.datagram.network/api/v1/partner/detail

Query Parameters

Parameters
Type
Required
Description
Example

secret

string

✅ Yes

Unique secret token identifying partner.

"pt_sec_abc123XYZ!*"

partner_node_id

string

✅ Yes

External ID of the partner node.

"partner_12345"

Authentication

Add the organization token in the Authorization header:

  • Example: Authorization: <token, optional>.

Example Request

GET /api/v1/partner/detail?secret=<partner-secret>&partner_node_id=dg-node-1 HTTP/1.1
Host: stats.api.datagram.network
Authorization: <organization token>

Responses

The request was successful. The server returns a structured JSON object containing metadata about the partner’s current status in the network.

Field
Type
Description
Example

connection_status

string

Connection status ("connected" or "disconnected")

"connected"

total_uptime

integer

Total uptime in Unix timestamp (ms).

99999

partner_node_id

string

Identifier of the external partner node.

"partner_12345"

Example:

{
  "data": {
    "connection_status": "connected",
    "total_uptime": 99999,
    "partner_node_id": "partner_12345"
  }
}

Last updated