Authentication

Obtain an API token for use in the Authorization header for all subsequent requests.

Get Token

Method: POST Endpoint: /custom/api/v1/auth-token

Request Fields

Field	Type	Required	Description	Example
username	string	Yes	Mobile number with country code (Velocity Shipping Username)	+91xxxxxxxxxx
password	string	Yes	Velocity Shipping Account password	Your password

Important: Creating a new token will revoke all previous tokens. Cache the token on your end and reuse it until expiry. Avoid generating a new token for every API request.

Account Lockout: 5 consecutive failed login attempts with an incorrect password may result in a temporary account lock.

Notes

• Use Authorization: {{token}} in all secured endpoints.
• Token will be valid for 24 hours.

Sample Request

curl --location 'https://shazam.velocity.in/custom/api/v1/auth-token' \
--header 'Content-Type: application/json' \
--data-raw '{
  "username": "+919866340090",
  "password": "YourPassword123"
}'

Success Response

{
  "token": "bbqRkOXw0xWLuYj9ubnDwg",
  "expires_at": "2025-09-17T10:11:40"
}

Error Response

{
  "error": "Invalid credentials",
  "status": 401
}

Using the Token

Include the token in the Authorization header for all authenticated API calls:

curl --location 'https://shazam.velocity.in/custom/api/v1/warehouse' \
--header 'Content-Type: application/json' \
--header 'Authorization: bbqRkOXw0xWLuYj9ubnDwg' \
--data '{...}'