Introduction

                           
Url for Pushing Orders:   
 url=https://api.fastcoo-tech.com/API_v2/CreateOrder

The process allows to create shipments in System.

➢ Please follow below tables to understand the parameters details

Name	Mandatory	Input & Length	Description
customerId	YES	String(20)	UID – Account ID
secret_key	YES	String(25)	Authentication ID (Provided By Fastcoo)
BookingMode	YES	String(5)	Payment Mode CC or COD
codValue	YES	Float(10,2)	Total COD amount
reference_id	YES	String(50)	Order Number
origin	YES	Mediumint(9)	Consignor City
destination	YES	Mediumint(9)	Consignee City
service	YES	Int(5)	Express or Advance Delivery Service
sender_name	YES	String(50)	Consignor Name
sender_address	YES	String(100)	Consignor Address
sender_phone	YES	String(25)	Consignor Phone
sender_email	YES	String(25)	Consignor Email
receiver_name	YES	String(30)	Consignee Name
receiver_address	YES	String(255)	Consignee Address
receiver_phone	YES	String(25)	Consignee Phone
receiver_email	YES	String(30)	Consignee Email
description	YES	String(250)	Detail of the Shipment/Comment
pieces	YES	Int	Number of Pieces of the box
weight	YES	Int	Weight of the complete box
national_address_id	No	String	National Address ID
sender_national_address_id	No	String	Sender National Address ID
sender_latitude	No	Float	Sender Latitude Value
sender_longitude	No	Float	Sender Longitude Value
area	No	String	Area Value
latitude	No	Float	Receiver Latitude Value
longitude	No	Float	Receiver Longitude Value

Service Type:

Service Name	ID
Express Service	X
Advance Service	X

▪ Ask for Service ID

                              
   { 
"format": "json", 
"secret_key":"xxxx", 
"method": "CreateOrder", 
"customerId": "1xxxx", 
"param": { 
"sender_phone": "9xxxxxxxxx", 
"sender_name": "John", 
"sender_email": "John@gmail.com", 
"receiver_email": "John@gmail.com", 
"description": "Food Products", 
"origin": "Riyadh", 
"receiver_phone": "9xxxxxxxxx", 
"sender_address": "Sulayi", 
"receiver_name": "Kick", 
"destination": "Riyadh", 
"BookingMode": "COD", 
"pieces":"1", 
"weight":"1", 
"receiver_address": "As Sawadi Khaldiyah", 
"reference_id": "newapiref01", 
"codValue": "1", 
"national_address_id":"xxxx",
"sender_national_address_id":"xxxx",
"sender_latitude":"xxxxx",
"sender_longitude":"xxxxx" ,
"area":"xxxx",
"latitude":"xxxxx",
"longitude":"xxxxx"
} 
}

❖Response Code

Code	Reason
200	Successful
401	Authentication Error
400	Already Exist
134	Order ID should not contain #
135	Reference ID is Required
126	Receiver ID is Required
127	Receiver phone is Required
128	Receiver City is Required
129	Receiver City is Incorrect

Shipment Tracking API

{
    "customerId": "1001xxxxxx",
    "param": {
        "search_type": "awb",
        "search_val": "FSLxxxxxx"
    }
}

{
    "customerId": "100xxxxx",
    "param": {
        "search_type": "ref_no",
        "search_val": "REF9xxxxxx"
    }
}

                           
{
    "status": 200,
    "shipment_data": {
        "awb_no": "FSL3xxxxxxxx",
        "entry_date": "2025-10-06 14:03:03",
        "payment_method": "COD",
        "weight": "2",
        "status": " Cancel",
        "code": "C",
        "shipping_company": "",
        "shipping_tracking_no": null,
        "origin": "Riyadh",
        "destination": "Riyadh",
        "ref_no": "TESTxxxxx"
    },
    "sender_info": {
        "name": "test10",
        "mobile": "055xxxxxx",
        "address": "Olaya"
    },
    "receiver_info": {
        "name": "test4",
        "mobile": "05xxxxxx",
        "address": "Near Tower"
    },
    "travel_history": [
        {
            "new_status": "Booked-Pickup Scheduled",
            "status_id": "12",
            "activities": "Booked-Pickup Scheduled",
            "details": "Booked-Pickup Scheduled",
            "code": "B",
            "comment": "",
            "entry_date": "2025-10-06 14:07:02"
        },
        {
            "new_status": "Out for delivery",
            "status_id": "5",
            "activities": "Out for Delivery",
            "details": "Out for Delivery, DRS No DSAXXXX",
            "code": "OD",
            "comment": "",
            "entry_date": "2025-12-30 09:17:10"
        },
        {
            "new_status": " Delivered",
            "status_id": "30",
            "activities": "Delivered",
            "details": "Order Delivered",
            "code": "POD",
            "comment": "Order Delivered",
            "entry_date": "2025-12-30 10:10:24"
        }
    ]
}

1. AWB Number Tracking API (Track Shipments)

This API guide will be used for tracking shipment using AWB’s on Shipping Company System to collect shipment data values for clients.

Test AWB# (Put anything which you successfully create) to get the shipment details

API Details:

URL: https://api.fastcoo-tech.com/Order/track/detail

Table 1. API Details

Parameter	Type	Description	Mandatory	Code
Method	String	HTTP Method used for API request (POST)	Yes	-
Content-Type	Header	Defines request format. Use: application/json	Yes	-
customerId	String	Unique customer authentication ID	Yes	401
search_type	String	Type of search to perform. Allowed values: awb, ref_no	Yes	126
search_val	String	Value based on search type. Example: AWB Number or Reference Number	Yes	125

Response Codes:

Code 200: Success - Shipment data fetched successfully
Code 125: Search Value is required
Code 126: Search Type is required
Code 401: Authentication error, please check customerId
Code 404: No shipment data found

Status Codes:

Main Category

S.N	Main Status	code
1.	Not Delivered
2.	On Process	OP
3.	Pick Up Collected	PUC
4.	Out for delivery	OD
5.	Return	DL
6.	Shelve	SH
7.	In Transit	IT
8.	Damage Shipment Arrival	DSA
9.	Hold for pickup
10.	Delivered	POD
11.	Booked-Pickup Scheduled	B
12.	Received Inbound	RI
13.	Ready For Delivery	RFDE
13.	General Update	GU
14.	CS Update
15.	Booked-reverse pick	RP
16.	Cancelled as per Client request.	CCR
17.	Forward to Delivery Station	FDD
18.	Missing Shipments	MS
19.	Damage Shipments	DS

Shipment Cancel API

This API is used to cancel an already created shipment. Please provide your Customer ID and Booking ID to cancel the shipment. All values shown below are for demo (dummy) purposes only.

URL:
https://api.fastcoo-tech.com/API/deleteShipment

Method: POST


{
  "customerId": "1XXXXXX",
  "booking_id": "1XXXXXX"
}

Response Codes:

Code 1: Shipment successfully cancelled
Code 5: Order not found or already cancelled
Code 0: Authentication error, please check credentials

Sample Success Response


{
  "error": false,
  "code": 1,
  "message": "Order successfully cancelled",
  "awb_no": "AWB_XXXXXX"
}

RATE CALCULATOR API

REQUIRED PARAM: { "customer_id":"1xxxxxxxxxx", "service_id":"Express Service", "origin":"Riyadh", "destination":"Riyadh", "weight":1 }

Url: https://api.fastcoo-tech.com/API/rate

                           
 { 
"customer_id":"1xxxxxxxxx", 
"service_id":"Express Service", 
"origin":"Riyadh", 
"destination":"Riyadh", 
"weight":1
}

PRINT SHIPPING LABEL API

All you have to do is send request for the label followed by the API to get the PDF label

Url: https://api.fastcoo-tech.com/API/Print/

Eg: https://api.fastcoo-tech.com/API/Print/FSL5836143515