Partner Details

Request

Retrieve detailed metadata about a specific partner's participation in the network. This endpoint provides insights into the partner’s current operational status. It is typically used to monitor partner engagement and performance across the network.

Endpoint

GET /api/v1/partner/details

URL:

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

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 multiple partner nodes.	"partner_12345"

Authentication

Add the organization token in the Authorization header:

• Example: Authorization: <token, optional>.

Example Request

GET /api/v1/partner/details?secret=<partner-secret>&partner_node_id[]=dg-node-1&partner_node_id[]=dg-node-2 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": "dg-node-1"
    },
    {
      "connection_status": "disconnected",
      "total_uptime": 99998,
      "partner_node_id": "dg-node-2"
    }
  ]
}

400

401