NautilusAPI

Overview

The Nautilus API is a REST interface to warehouse operations data. Requests use JSON, resource-oriented URLs, and conventional HTTP status codes. v1 enters general availability in Q3 2026. Until then, we're onboarding select early-access customers.

Authentication

All requests authenticate with a Bearer token in the Authorization header. API keys are created in the Nautilus dashboard at launch. Keep secret keys server-side — they grant full access to your warehouse data.

Authorization: Bearer sk_live_4Kf2x9aQ8nL...

Products

Read and update the product catalog, stock levels, locations, and metadata. Bulk operations supported with cursor pagination via next_cursor.

GET https://api.Nautiluswms.com/v1/products?limit=50
Authorization: Bearer sk_live_4Kf2x9aQ8nL...

{
  "data": [
    {
      "id": "prod_8x4f2",
      "sku": "OAK-PLANK-12",
      "name": "Oak Plank 12in",
      "quantity_on_hand": 482,
      "location": "A-01-3",
      "updated_at": "2026-05-08T14:22:01Z"
    }
  ],
  "has_more": true
}

Scans

Record pick, putaway, receive, relocate, count, adjust, ship, and return actions from any device. Scans are the source of truth for stock movements.

POST https://api.Nautiluswms.com/v1/scans
Authorization: Bearer sk_live_4Kf2x9aQ8nL...
Content-Type: application/json

{
  "action": "pick",
  "sku": "OAK-PLANK-12",
  "location": "A-01-3",
  "quantity": 24,
  "device_id": "scanner_7f"
}

{
  "id": "scn_3k8d2",
  "recorded_at": "2026-05-08T14:22:01Z",
  "balance_after": 458
}

Webhooks

Real-time event delivery for low stock, location changes, cycle count results, and 20+ more event types. Configure endpoints in the dashboard. Reply 200 within 5 seconds to acknowledge; otherwise Nautilus retries with exponential backoff for 24 hours.

// Sent to your configured endpoint
POST https://your-app.com/Nautilus-webhook
Content-Type: application/json
Nautilus-Signature: "v1=8a2b..."

{
  "event": "low_stock",
  "data": {
    "sku": "OAK-PLANK-12",
    "quantity": 12,
    "threshold": 50
  }
}

// Reply 200 within 5s to acknowledge
// Otherwise Nautilus retries with exponential backoff

{
  "received": true
}

Capabilities

Everything in the Nautilus app is exposed through the API. You'll find endpoints and webhooks for each of the following.

Products & inventory

Read and update product catalog, stock levels, locations, and metadata. Bulk operations with cursor pagination.

Scan events

Record pick, putaway, receive, relocate, count, adjust, ship, and return actions from any device.

Webhooks

Real-time event delivery for low stock, location changes, cycle count results, and 20+ more event types.

Search

Query the same AI-powered search that powers the app — natural language across products, locations, and history.

Reports & analytics

Programmatic access to dashboards: throughput, accuracy, dwell time, route efficiency, anomaly scores.

SDKs & Zapier

Official Node and Python SDKs, plus 5,000+ no-code integrations via our Zapier app.

SDKs

Official SDKs for Node and Python. Plus a Zapier app for no-code workflows. All SDKs follow the same naming as the REST resources.

// Node.js
npm install @Nautiluswms/sdk

// Python
pip install Nautiluswms

Versioning

The API uses URI versioning — v1 today. Breaking changes ship behind new major versions; new fields and endpoints are added in-place without bumping. We commit to 12 months of advance notice before sunsetting any version, and to publishing migration guides at least 6 months ahead of cutover.

Support

Early-access customers get direct access to the engineering team. Email developers@Nautiluswms.com, join our developer Slack at launch, or reach out via the contact form.

If you're building something specific and want to discuss it before v1 ships, talk to our team — we're shaping the API based on real integrations.