API Documentation

Learn how to integrate with the Lunar Container Tracking API

https://lunar.pauz.digital/api

Authentication

All API requests require authentication using an API key in the Authorization header.

Authorization: Bearer your-api-key-uuid

curl -X GET \
  -H "Authorization: Bearer your-api-key-uuid" \
  "https://lunar.pauz.digital/api/tracking"

Container Tracking

Add containers to continuous tracking. The system syncs every 15 minutes and can notify you via email when status changes occur.

Email Notifications

Get notified via email when your container status changes or when the Last Free Day is approaching.

// When creating tracking
{
  "terminalCode": "MAH",
  "containerNumber": "BEAU5371613",
  "notifyEmails": ["dispatch@company.com", "logistics@company.com"]
}

// Update emails later
PATCH /tracking/:trackingId/notify
{
  "notifyEmails": ["new@company.com"]
}

Terminal Codes

The API supports 150+ terminal codes across ports and rail yards in North America.

GET https://lunar.pauz.digital/api/terminals

Response:
{
  "success": true,
  "count": 156,
  "terminals": [
    {
      "code": "MAH",
      "name": "Maher Terminal",
      "location": "New Jersey",
      "port": "NY/NJ"
    },
    ...
  ]
}

Error Handling

The API returns standard HTTP status codes and JSON error responses.

{
  "success": false,
  "error": {
    "code": "TRACKING_LIMIT_EXCEEDED",
    "message": "You have reached your tracking limit. Current: 20, Limit: 20",
    "current": 20,
    "limit": 20,
    "upgradeUrl": "/api/auth/plans",
    "timestamp": "2026-01-16T10:30:00Z"
  }
}