Tracking API for Enterprise Clients

API Documentation and Access Application

Use our tracking API to retrieve consignment status, shipment history, and latest milestone information for authorized clients and integration platforms.

Integration Support
paradisecontainerservice@gmail.com
Standard Rate Limit
120 requests per minute per API key

Authentication

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 Header
Authorization: Bearer YOUR_API_KEY

Endpoint 1: Public Tracking

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

Sample Request

cURL Request
curl "https://paradisecontainerservices.com/api/track.php?tracking_id=PCS24001"
JavaScript Request
fetch('https://paradisecontainerservices.com/api/track.php?tracking_id=PCS24001')
  .then(response => response.json())
  .then(data => console.log(data));
PHP Request
<?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;
Python Request
import requests

response = requests.get('https://paradisecontainerservices.com/api/track.php?tracking_id=PCS24001')
print(response.json())

Request Parameters

Parameter NameData TypeDescriptionMandatoryConstraints
tracking_id string Unique consignment tracking identifier assigned by Paradise Container Services. Yes Must match a valid shipment reference such as PCS24001.

Response Sample

JSON Response
{
  "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"
    }
  ]
}

Response Parameters

Field NameData TypeDescription
tracking_idstringThe shipment tracking reference.
originstringShipment origin location.
destinationstringFinal destination location.
statusstringLatest confirmed milestone status.
locationstring|nullLatest confirmed location for the consignment.
last_updateddatetime|nullTimestamp of the latest confirmed tracking event.
historyarray<object>Chronological tracking event history for the consignment.
history[].locationstringLocation for a single milestone event.
history[].statusstringStatus label for that milestone event.
history[].remarksstring|nullOperational comment or exception note for the event.
history[].timestampdatetimeWhen 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.

Endpoint 2: Protected Consignment Feed

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

Sample Request

cURL Request
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://paradisecontainerservices.com/api/consignments.php?page=1&limit=20"
JavaScript Request
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 Request
<?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;
Python Request
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())

Request Parameters

Parameter NameData TypeDescriptionMandatoryConstraints
Authorizationheader/stringBearer token header used for API authentication.YesFormat: Bearer YOUR_API_KEY
pageintegerPagination page number.NoMinimum value 1. Defaults to 1.
limitintegerNumber of records returned per page.NoMinimum 1, maximum 100. Defaults to 20.
statusstringFilters consignments by shipment status.NoMust match a valid status such as Booked, In Transit, or Delivered.
client_idintegerFilters results to a specific client record.NoPositive numeric client identifier.

Response Sample

JSON Response
{
  "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"
    }
  ]
}

Response Parameters

Field NameData TypeDescription
authorized_clientstringName of the client account authorized by the provided API key.
pageintegerCurrent page number returned in the response.
limitintegerMaximum records included in the current page.
totalintegerTotal consignments matching the requested filters.
dataarray<object>List of consignment objects returned for the requested page.
data[].idintegerInternal consignment record identifier.
data[].tracking_idstringUnique public shipment reference.
data[].originstringOrigin city or dispatch location.
data[].destinationstringDelivery city or destination location.
data[].statusstringCurrent shipment lifecycle status.
data[].created_atdatetimeWhen the consignment was created in the system.
data[].updated_atdatetimeMost recent update timestamp for the consignment record.
data[].company_namestringClient company associated with the consignment.
data[].vehicle_numberstring|nullAssigned vehicle number if a vehicle has been linked.

Onboarding Process

  1. Review the endpoint details, parameters, response structure, and integration limits.
  2. Submit the API application form with your company, contact, and expected usage details.
  3. Our team reviews the request, validates the business use case, and confirms traffic expectations.
  4. Approved clients receive API credentials that can be managed from our admin platform.

Apply for API Access

This form is intended for companies that want authenticated access to Paradise Container Services tracking data.

Integration Notes

  • Use HTTPS in production for all client integrations.
  • Store API keys only in secure server-side environments.
  • Apply retry and backoff logic rather than aggressive polling.
  • Contact paradisecontainerservice@gmail.com for onboarding or production queries.