API Reference

Rama Logistics API

Integrate with our API to track shipments, manage orders, and access real-time logistics data.

Base URL

bash

https://api.rama-logistics.com/v1

Authentication

All API requests must include your API key in the Authorization header:

bash

curl -H "Authorization: Bearer your_api_key" \ https://api.rama-logistics.com/v1/shipments

API Endpoints

Track Shipment

Get real-time tracking information for a shipment.

GET /shipments/:tracking_number

bash

curl -X GET \
  "https://api.rama-logistics.com/v1/shipments/RAMA123456" \
  -H "Authorization: Bearer your_api_key"

Response

json

{
  "tracking_number": "RAMA123456",
  "status": "in_transit",
  "current_location": "Kuwait City",
  "destination": "Dubai",
  "estimated_delivery": "2025-06-23T14:00:00Z",
  "last_update": "2025-06-21T22:58:41Z",
  "events": [
    {
      "timestamp": "2025-06-21T22:58:41Z",
      "location": "Kuwait City",
      "status": "in_transit",
      "description": "Package in transit to next facility"
    }
  ]
}

Create Shipment

Create a new shipment in the system.

POST /shipments

bash

curl -X POST \
  "https://api.rama-logistics.com/v1/shipments" \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "pickup_address": "Kuwait City, Kuwait",
    "delivery_address": "Dubai, UAE",
    "package_details": {
      "weight": 5.2,
      "dimensions": "30x20x15",
      "type": "parcel"
    },
    "service_type": "express"
  }'

Get Shipping Rates

Calculate shipping rates for a package.

POST /rates/calculate

bash

curl -X POST \
  "https://api.rama-logistics.com/v1/rates/calculate" \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "origin": "Kuwait",
    "destination": "Dubai",
    "weight": 5.2,
    "dimensions": "30x20x15",
    "service_type": "express"
  }'

Webhooks

Set up webhooks to receive real-time updates about your shipments:

bash

curl -X POST \
  "https://api.rama-logistics.com/v1/webhooks" \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-server.com/webhook",
    "events": ["shipment.created", "shipment.in_transit", "shipment.delivered"]
  }'

Need Integration Support?

Our developer team is ready to help you integrate with our API.

Contact API Support