API Reference - NearNode

Base URL

https://nearnode.io/api/v1

All API requests require a Bearer token in the Authorization header:

curl -H "Authorization: Bearer sk_live_..." https://nearnode.io/api/v1/nodes

API keys are scoped to your organization. Generate keys in the NearNode Console under Developers → API Keys.

API keys grant full access to your organization’s data. Store them securely and rotate them periodically.

All responses follow a consistent structure:

{
  "data": { ... },
  "error": null
}

Error responses:

{
  "data": null,
  "error": "Description of what went wrong"
}

Code	Meaning
`200`	Success
`201`	Created
`400`	Bad request (invalid input)
`401`	Unauthorized (missing or invalid API key)
`404`	Resource not found
`422`	Validation error
`429`	Rate limited
`500`	Internal server error

Rate limit headers are included in every response:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 97
X-RateLimit-Reset: 1707494400

POST /nodes — Generate a new physical touchpoint.

GET /nodes — Retrieve all nodes in your organization.

GET /nodes/{slug} — Retrieve a single node.

PATCH /nodes/{slug} — Update payload, label, or status.

DELETE /nodes/{slug} — Permanently delete a node.

POST /batches — Create nodes in bulk.