Before to interact with the Vehicle Tracking API, your system must be authenticated using a Basic Auth header with valid API credentials.

Step 1: Just Write to Us. We'll Handle the Rest ✉️

If you’re ready to start integrating with the Vehicle Tracking API, simply reach out to your Suntransfers Supplier Manager or email us at [email protected] with the subject:

| “Vehicle Tracking API – Credential Request”

We’ll handle the rest and create your credentials for you. Once ready, we’ll send back:

Username (usually your email or supplier code)
Password (used for Basic Auth)

We’ll make sure you’re set up quickly and ready to integrate.

🤝
Don’t worry
we’re here to help you at every step. Whether it’s credentials, testing, or going live, our goal is to make the process easy and smooth for you.

Step 2: Authenticate Your Requests🔑

All API requests must include the Authorization header using the Basic Auth scheme:

Authorization: Basic <base64(username:password)>

Username: your_supplier_code
Password: your_secure_password

Authorization: Basic eW91cl9zdXBwbGllcl9jb2RlOnlvdXJfc2VjdXJlX3Bhc3N3b3Jk

💡 You can use any Base64 encoder to generate this header.

Step 3: Test in the Staging Environment 🧪

Before sending real data, test your implementation in our staging (BIZ) environment:

Staging (biz) URL: Tracking - Staging

The API structure and authentication method are identical to production.
Use this environment to simulate full, realistic journeys, from pickup to drop-off, by sending events in real time following the Recommended Event Workflow.

This helps ensure your integration is correctly implemented and ready for production activation.
Once testing is successfully completed, request production credentials and the production URL from your Suntransfers contact.

📘
View the full 🛰️ Vehicle Tracking - Endpoints

Important Security Notes ⚠️

Your username and password are confidential Do not expose them in frontend apps.
If credentials are invalid or missing, the API will return a 401 Unauthorized response.
🔁 To reset or rotate your credentials, Contact Suntransfers tech support.