Skip to main content
GET
Retrieve all nodes

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

publisherId
string
required

Query Parameters

include_banned
boolean

Whether to include banned nodes in the results. Defaults to including them; pass false to exclude.

page
integer
default:1

Page number of the nodes list

limit
integer
default:10

Number of nodes to return per page. Values above the declared maximum are outside the contract, but this service does not reject them: it serves the maximum instead, and the page size actually served is echoed back as limit (and drives totalPages), so a clamp is always detectable by the caller. Treat the maximum as the real page stride — a client that asks for more and assumes it received more will miss rows. 0 and negative values are also accepted and select the default, which is why no minimum is declared: sub-1 is meaningful here, not invalid.

Required range: x <= 100

Response

List of all nodes

limit
integer

Maximum number of nodes per page

nodes
object[]
page
integer

Current page number

total
integer

Total number of nodes available

totalPages
integer

Total number of pages available