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

200

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

400

401