Albatta Delivery API

Empower your business with seamless delivery integration

API Overview

Purpose

The Albatta Delivery API enables corporate clients to seamlessly integrate their systems with our comprehensive delivery platform. Automate order management, real-time tracking, and streamline your logistics operations.

Integration Benefits

Automated order creation and management
Real-time delivery tracking
Instant notifications and updates
Comprehensive reporting and analytics

Base URLs

Sandbox Testing Environment

https://api.test.albattadelivery.com

Use for development and testing

Production Live Environment

https://api.albattadelivery.com

Use for production traffic

Quick Start Example

Here's a complete example of creating a delivery order with pickup and delivery addresses

POST {{base_url}}/api/orders/create
                            Host: https://api.albattadelivery.com
                            Content-Type: application/json
                            Authorization: ApiKey YOUR_API_KEY

                            {
                            "pickupAddress": {
                            "governanceId": 2,
                            "areaId": 15,
                            "block": "10",
                            "street": "5",
                            "office": "",
                            "floor": "",
                            "house": "",
                            "avenue": "",
                            "building": "12",
                            "contactCountryCode": "+965",
                            "contactName": "Warehouse Manager",
                            "contactPhone": "90001122",
                            "latitude": 29.337500,
                            "longitude": 48.073600,
                            "notes": "take from driver"
                            },
                            "pickupDate": "2026-03-16T14:30:00",
                            "paymentMethod": "KNET",
                            "deliveryAddress": {
                            "governanceId": 2,
                            "areaId": 22,
                            "block": "5",
                            "street": "3",
                            "office": "",
                            "floor": "",
                            "house": "",
                            "avenue": "",
                            "building": "45",
                            "contactCountryCode": "+965",
                            "contactName": "John Doe",
                            "contactPhone": "55551234",
                            "latitude": 29.339368,
                            "longitude": 48.002779,
                            "notes": "Call upon arrival"
                            },
                            "packageDetails": {
                            "weight": 2.5,
                            "description": "Documents",
                            "value": 50.000
                            },
                            "notes": "Handle with care"
                            }

Example Response

{
                                "responseCode": 200,
                                "message": "Success",
                                "results": {
                                "orderId": "ORD-2025-001",
                                "orderNumber": "ALT-20260316-001",
                                "status": "pending",
                                "createdAt": "2026-03-16T10:30:00"
                                }
                                }

Key Features

Order Management

Create, update, and track delivery orders programmatically with full lifecycle management.

Real-time Tracking

Monitor delivery status in real-time with GPS tracking and automated status updates.

Notifications

Receive instant webhooks and notifications for order events and status changes.

Secure Authentication

Enterprise-grade security with JWT token-based authentication.

Analytics & Reports

Access detailed delivery analytics and generate comprehensive reports.

RESTful API

Modern REST architecture with JSON responses and comprehensive documentation.

API Endpoints Overview

Orders

POST /api/orders/create
GET /api/orders/details
GET /api/orders/history
POST /api/orders/cancel

Master Data

GET /api/master/governances/ar
GET /api/master/areas
GET /api/master/vehicle-types

Reports

GET /api/reports/corporate-orders
GET /api/exceptions/all

Price & Bulk Operations

POST /api/orders/calculate-price
POST /api/orders/create-bulk

Ready to Get Started?

Download our Postman collection and start testing the API immediately

No credentials required for sandbox testing