curl https://nearnode.io/api/v1/nodes?status=active&limit=10 \
-H "Authorization: Bearer sk_live_..."
{
"data": [
{
"id": "node_abc123...",
"slug": "k9m2xp4q",
"label": "Office Front Door",
"url": "https://nearnode.io/v/k9m2xp4q",
"function_type": "redirect",
"payload": {
"url": "https://acme.com/welcome"
},
"status": "active",
"scan_count": 1247,
"created_at": "2026-02-10T10:00:00Z"
}
],
"total": 42
}
Nodes
List Nodes
Retrieve all nodes in your organization.
GET
/
api
/
v1
/
nodes
curl https://nearnode.io/api/v1/nodes?status=active&limit=10 \
-H "Authorization: Bearer sk_live_..."
{
"data": [
{
"id": "node_abc123...",
"slug": "k9m2xp4q",
"label": "Office Front Door",
"url": "https://nearnode.io/v/k9m2xp4q",
"function_type": "redirect",
"payload": {
"url": "https://acme.com/welcome"
},
"status": "active",
"scan_count": 1247,
"created_at": "2026-02-10T10:00:00Z"
}
],
"total": 42
}
Query Parameters
string
Filter by lifecycle status. One of
draft, in_production, active, paused, lost, retired.string
Filter by payload type. One of
redirect, vcard, wifi, microsite, digital_card, action.string
Filter by batch ID to list nodes from a specific batch.
integer
default:"50"
Number of results per page (max 100).
integer
default:"0"
Pagination offset.
Response
array
Array of node objects.
integer
Total number of matching nodes.
curl https://nearnode.io/api/v1/nodes?status=active&limit=10 \
-H "Authorization: Bearer sk_live_..."
{
"data": [
{
"id": "node_abc123...",
"slug": "k9m2xp4q",
"label": "Office Front Door",
"url": "https://nearnode.io/v/k9m2xp4q",
"function_type": "redirect",
"payload": {
"url": "https://acme.com/welcome"
},
"status": "active",
"scan_count": 1247,
"created_at": "2026-02-10T10:00:00Z"
}
],
"total": 42
}