Skip to main content
Fleet Management is how NearNode scales from 10 nodes to 100,000. Instead of creating nodes one by one, you generate them in Batches — with sequential serial IDs, shared configurations, and group-level lifecycle tracking.
Ops Tip: You can create and manage batches entirely from the Dashboard under Fleet. The batch wizard walks you through configuration, preview, and generation.

​
Creating a Batch

curl -X POST https://nearnode.io/api/v1/batches \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "label": "Q1 2026 Business Cards",
    "prefix": "VID-2026",
    "quantity": 100,
    "function_type": "vcard",
    "base_payload": {
      "organization": "VidiAI",
      "website": "https://vidiai.ch"
    }
  }'
This generates 100 nodes with serial IDs VID-2026-001 through VID-2026-100. Each node gets a unique slug and permanent scan URL.
A single batch can generate up to 500 nodes. Need more? Create multiple batches with sequential prefixes (VID-2026-A, VID-2026-B, etc.).

​
Batch Lifecycle

Every batch moves through a tracked lifecycle. Status transitions are logged automatically.
1

Pending

Batch created, configuration saved. Nodes not yet generated.
2

Generating

Node generation in progress. Slugs and serial IDs are being assigned.
3

Ready

All nodes generated. Awaiting hardware write (NFC encoding or QR printing).
4

Writing

NFC tags are being written via the Writer module. Progress tracked per-node.
5

Deployed

All tags written and verified. Batch is fully deployed in the field.
If generation fails (e.g., duplicate prefix conflict), the batch moves to failed status. No partial batches are created — it’s all or nothing.

​
CSV Manifest

After generation, download the CSV manifest for your printing or encoding workflow: 
serial_id,slug,url,status
VID-2026-001,k9m2xp4q,https://nearnode.io/v/k9m2xp4q,active
VID-2026-002,r3n7yb8w,https://nearnode.io/v/r3n7yb8w,active
VID-2026-003,m5t8zc2v,https://nearnode.io/v/m5t8zc2v,active
...
Import the manifest directly into your NFC writing tool or QR code generator. The url column contains the complete scan URL ready for encoding.

​
Templates

Bind a batch to a Template to enforce brand consistency across all generated nodes. Templates define default payload values and locked fields that cannot be overridden at the individual node level.
ConceptDescription
base_payloadDefault values applied to every node in the batch
locked_fieldsFields that editors cannot override (e.g., organization, website)
Template bindingApplied at generation time — cannot be changed after
Ops Tip: Templates are managed under Templates in the Dashboard. Create a “Corporate vCard” template once, then reuse it across every batch.

​
Use Cases

Business Cards

Generate vCard nodes for an entire team. Each card gets a unique slug but shares the company template.

Event Badges

Deploy 500 NFC badges for a conference. Route to check-in during the event, post-event surveys after.

Product Packaging

Embed QR codes in packaging that link to manuals, warranty registration, or authenticity verification.

Asset Tracking

Tag equipment, vehicles, or inventory. Scan to view maintenance history, location logs, or documentation.