Ninja Van · Rate Limits

Ninjavan Rate Limits

Ninja Van does not publish fixed numeric rate limits for the ninjaAPI in its public documentation. Practical throughput is governed by the OAuth2 token lifecycle (tokens are short-lived and should be cached and reused rather than re-minted per request; regenerate only within about five minutes of expiry or on an HTTP 401) and by the integration audit that gates production access. Access to some endpoints is explicitly gated: waybill generation requires prior approval, and the sandbox is restricted to the Singapore (sg) country code.

Ninjavan Rate Limits is the machine-readable rate-limit profile for Ninja Van on the APIs.io network, conforming to the API Commons Rate Limits specification.

It captures 4 rate-limit definitions, measuring requests and tokens.

The profile also includes 3 backoff/retry policies defined and response codes documented for throttled, unauthorized, and forbidden.

Tagged areas include Logistics, Last-Mile Delivery, Shipping, Southeast Asia, and Rate Limiting.

4 Limits Throttle: 429
LogisticsLast-Mile DeliveryShippingSoutheast AsiaRate LimitingQuotas

Limits

API Requests account
requests
not published
No fixed numeric request-rate limit is documented for the ninjaAPI.
OAuth Token Lifetime account
tokens
short-lived (cache and reuse)
Access tokens expire; regenerate within ~5 minutes of expiry or on HTTP 401 rather than per request.
Waybill Generation account
requests
access-gated
Requires prior access approval from Ninja Van before the endpoint can be used.
Sandbox Country Scope environment
requests
Singapore (sg) only
The sandbox environment only supports the sg country code.

Policies

Token Caching
Store the access token and its expiry; reuse until close to expiry to avoid unnecessary token requests.
Backoff Strategy
Implement exponential backoff with jitter and honor Retry-After on 429 responses; re-authenticate on 401.
Integration Audit
Production access is granted only after passing Ninja Van's integration audit, which includes generating sample orders.

Sources