v1

latestOpenAPI 3.0.02026-07-17493090.2 KB
Splinter Registry

Fetch a node in the registry by its identity

This endpoint can be used to view a specific nodes in the registry.

This endpoint requires the permission "registry.read".

get/registry/nodes/{identity}

Path parameters

identitystring required

identity of node to fetch

Headers

Authorizationstring required

The client's authorization, which the server resolves to an identity. Currently supports Biome JWT (if Biome credentials is enabled), Cylinder JWT, and OAuth2 bearer tokens.

SplinterProtocolVersioninteger
Example:2

The protocol version which the client can understand. If not provided, the node will respond using its latest protocol version.

Response

The node was successfully retrieved

Example response

{
  "data": {
    "identity": "node-123123-asdf",
    "endpoints": [
      "tcps://12.0.0.123:8431"
    ],
    "display_name": "Cargill - Node 1",
    "keys": [
      "03e0e5086beffc640ec0d149d4f1197fdde0f338afac774541831281c6fd91cbe0"
    ],
    "metadata": {
      "company": "Cargill",
      "status": "Up"
    }
  }
}