Skip to main content

List Nodes

GET/api/v1/nodes/

Query parameters

  • project_idQuerystringoptional

    Identifier of the project to scope the request to. Optional; if omitted, the account's default project is used.

    • optional
    • if omitted, the request is applied to the default project
    example{{project_id}}
  • apikeyQuerystringoptional

    API key for authenticating the request

    • required
    • non-empty string
    example{{api_key}}
  • locationQuerystringoptional

    Specifies the location filter for the node list request.

    • must be a non-empty string
    • should be URL-encoded if it contains special characters
    example{{location}}

Responses

200Successful response
object
codeinteger

HTTP status code of the response

example200
  • must be a valid HTTP status code (100-599)
  • required
dataarray
errorsobject
messagestring

Status message describing the outcome of the list nodes request.

exampleSuccess
  • Must be a non-empty string
  • Typically limited to a short length (e.g., ≤255 characters)