Tenant API

v1.0

API for pulling shipment and seller data into external ERP and accounting systems

Overview

The Tenant API provides read-only access to shipment and seller data for integration with external Enterprise Resource Planning (ERP) systems, accounting software, and business intelligence tools. This API is designed for bulk data extraction and reporting purposes.

Access Control

Tenant API tokens are managed by superAdmin users in the Admin Settings page. Contact your system administrator to obtain credentials.

Authentication

All Tenant API requests require Bearer token authentication. Include your API token in the Authorization header:

http

Authorization: Bearer your_tenant_api_token_here

Token Management

Tokens are generated in Admin Settings > Tenant API Credentials
Only one active token exists at a time
Regenerating a token immediately invalidates the previous token
Tokens are 128-byte cryptographic strings

Error Responses

Status	Description
`401 Unauthorized`	Missing, invalid, or revoked API token
`429 Too Many Requests`	Rate limit exceeded (60 requests per 15 seconds)

Base URL

Environment	URL
Production	`https://nbox.now/api/erp`
Staging	`https://staging.nbox.now/api/erp`

Rate Limiting

The Tenant API has dedicated rate limits to ensure system stability:

60 requests per 15-second window
Rate limit headers are included in all responses

Header	Description
`X-RateLimit-Limit`	Maximum requests allowed per window
`X-RateLimit-Remaining`	Requests remaining in current window
`X-RateLimit-Reset`	Unix timestamp when the window resets