Use our tracking API to retrieve consignment status, shipment history, and latest milestone information for authorized clients and integration platforms.
Protected endpoints require a Bearer API key issued to an approved company account. Keep your API key server-side and never expose it in browser code or public repositories.
Authorization: Bearer YOUR_API_KEY
This endpoint returns the latest validated status for a single consignment and does not require an API key.
GET /api/track.php?tracking_id=PCS24001
curl "https://paradisecontainerservices.com/api/track.php?tracking_id=PCS24001"
fetch('https://paradisecontainerservices.com/api/track.php?tracking_id=PCS24001')
.then(response => response.json())
.then(data => console.log(data));
<?php
$ch = curl_init('https://paradisecontainerservices.com/api/track.php?tracking_id=PCS24001');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
import requests
response = requests.get('https://paradisecontainerservices.com/api/track.php?tracking_id=PCS24001')
print(response.json())
| Parameter Name | Data Type | Description | Mandatory | Constraints |
|---|---|---|---|---|
tracking_id |
string | Unique consignment tracking identifier assigned by Paradise Container Services. | Yes | Must match a valid shipment reference such as PCS24001. |
{
"tracking_id": "PCS24001",
"origin": "Bangalore",
"destination": "Chennai",
"status": "In Transit",
"location": "Hosur",
"last_updated": "2026-04-15 18:45:00",
"history": [
{
"location": "Hosur",
"status": "In Transit",
"remarks": "Vehicle departed and crossed state border",
"timestamp": "2026-04-15 18:45:00"
},
{
"location": "Bangalore",
"status": "Booked",
"remarks": "Shipment received at Paradise Container Services hub",
"timestamp": "2026-04-14 09:15:00"
}
]
}
| Field Name | Data Type | Description |
|---|---|---|
tracking_id | string | The shipment tracking reference. |
origin | string | Shipment origin location. |
destination | string | Final destination location. |
status | string | Latest confirmed milestone status. |
location | string|null | Latest confirmed location for the consignment. |
last_updated | datetime|null | Timestamp of the latest confirmed tracking event. |
history | array<object> | Chronological tracking event history for the consignment. |
history[].location | string | Location for a single milestone event. |
history[].status | string | Status label for that milestone event. |
history[].remarks | string|null | Operational comment or exception note for the event. |
history[].timestamp | datetime | When the tracking event was recorded in the system. |
Tracking events are published when operational milestones are validated by dispatch teams, drivers, hubs, or approved client integrations.
This endpoint returns a paginated list of consignments for authorized API clients and requires a Bearer API key.
GET /api/consignments.php?page=1&limit=20
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://paradisecontainerservices.com/api/consignments.php?page=1&limit=20"
fetch('https://paradisecontainerservices.com/api/consignments.php?page=1&limit=20', {
headers: {
Authorization: 'Bearer YOUR_API_KEY'
}
})
.then(response => response.json())
.then(data => console.log(data));
<?php
$ch = curl_init('https://paradisecontainerservices.com/api/consignments.php?page=1&limit=20');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer YOUR_API_KEY'
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
import requests
headers = {'Authorization': 'Bearer YOUR_API_KEY'}
response = requests.get('https://paradisecontainerservices.com/api/consignments.php?page=1&limit=20', headers=headers)
print(response.json())
| Parameter Name | Data Type | Description | Mandatory | Constraints |
|---|---|---|---|---|
Authorization | header/string | Bearer token header used for API authentication. | Yes | Format: Bearer YOUR_API_KEY |
page | integer | Pagination page number. | No | Minimum value 1. Defaults to 1. |
limit | integer | Number of records returned per page. | No | Minimum 1, maximum 100. Defaults to 20. |
status | string | Filters consignments by shipment status. | No | Must match a valid status such as Booked, In Transit, or Delivered. |
client_id | integer | Filters results to a specific client record. | No | Positive numeric client identifier. |
{
"authorized_client": "Bosch API Integration",
"page": 1,
"limit": 20,
"total": 2,
"data": [
{
"id": 1,
"tracking_id": "PCS24001",
"origin": "Bangalore",
"destination": "Chennai",
"status": "In Transit",
"created_at": "2026-04-14 09:15:00",
"updated_at": "2026-04-15 18:45:00",
"company_name": "Bosch India",
"vehicle_number": "KA01AB1234"
}
]
}
| Field Name | Data Type | Description |
|---|---|---|
authorized_client | string | Name of the client account authorized by the provided API key. |
page | integer | Current page number returned in the response. |
limit | integer | Maximum records included in the current page. |
total | integer | Total consignments matching the requested filters. |
data | array<object> | List of consignment objects returned for the requested page. |
data[].id | integer | Internal consignment record identifier. |
data[].tracking_id | string | Unique public shipment reference. |
data[].origin | string | Origin city or dispatch location. |
data[].destination | string | Delivery city or destination location. |
data[].status | string | Current shipment lifecycle status. |
data[].created_at | datetime | When the consignment was created in the system. |
data[].updated_at | datetime | Most recent update timestamp for the consignment record. |
data[].company_name | string | Client company associated with the consignment. |
data[].vehicle_number | string|null | Assigned vehicle number if a vehicle has been linked. |
This form is intended for companies that want authenticated access to Paradise Container Services tracking data.