Ninja Van API

How to authenticate

1. 1Contact Ninja Van (or your account manager) to become a shipper and get API credentials; there is a sandbox environment (api-sandbox.ninjavan.co).
2. 2Get an access token via POST /SG/2.0/oauth/access_token with client_id, client_secret, grant_type=client_credentials.
3. 3Tokens are long-lived; cache until expiry.
4. 4Create orders on /SG/4.2/orders and subscribe to webhook events for tracking.

Example request

curl -X POST 'https://api.ninjavan.co/SG/2.0/oauth/access_token' -H 'Content-Type: application/json' -d '{"client_id":"YOUR_ID","client_secret":"YOUR_SECRET","grant_type":"client_credentials"}'

Example response

{"access_token":"eyJhbGciOi...","expires_in":3600,"token_type":"bearer"}