Create Shipment (Weight-Based) | Impala Courier

Creates a shipment priced by weight. amount should match the value returned by Calculate Pricing for this weight/route — the server may reject mismatched amounts.

Body parameters

Field	Type	Required	Description
senderName	string	Yes	Pickup contact name
senderPhone	string	Yes	E.164 format, e.g. +265991234567
senderCity	string	Yes	Pickup city
receiverName	string	Yes	Delivery contact name
receiverPhone	string	Yes	E.164 format
receiverCity	string	Yes	Delivery city
serviceType	string	Yes	`standard` or `express`
declaredValue	number	Yes	Value of goods in MWK, for insurance purposes
amount	number	Yes	Shipping cost in MWK, from Calculate Pricing
weight	number	Yes	Package weight in kg
pricingType	string	Yes	Must be `weight_based`
description	string	Yes	Order/contents description
ecommerceOrderId	string	Yes	Your platform’s order ID, for reconciliation
shopId	string	Yes	Your shop code, provided by Impala Courier

Creates a shipment priced by weight. `amount` should match the value returned by **Calculate Pricing** for this weight/route — the server may reject mismatched amounts. **Body parameters** | Field | Type | Required | Description | |---|---|---|---| | senderName | string | Yes | Pickup contact name | | senderPhone | string | Yes | E.164 format, e.g. +265991234567 | | senderCity | string | Yes | Pickup city | | receiverName | string | Yes | Delivery contact name | | receiverPhone | string | Yes | E.164 format | | receiverCity | string | Yes | Delivery city | | serviceType | string | Yes | `standard` or `express` | | declaredValue | number | Yes | Value of goods in MWK, for insurance purposes | | amount | number | Yes | Shipping cost in MWK, from Calculate Pricing | | weight | number | Yes | Package weight in kg | | pricingType | string | Yes | Must be `weight_based` | | description | string | Yes | Order/contents description | | ecommerceOrderId | string | Yes | Your platform's order ID, for reconciliation | | shopId | string | Yes | Your shop code, provided by Impala Courier |

Authentication

X-API-Keystring

API Key authentication via header

Request

This endpoint expects an object.

amountintegerRequired

shopIdstringRequired

weightdoubleRequired

senderCitystringRequired

senderNamestringRequired

descriptionstringRequired

pricingTypestringRequired

senderPhonestringRequired

serviceTypestringRequired

receiverCitystringRequired

receiverNamestringRequired

declaredValueintegerRequired

receiverPhonestringRequired

ecommerceOrderIdstringRequired

Response

Created

dataobject

successboolean

Creates a shipment priced by weight. amount should match the value returned by Calculate Pricing for this weight/route — the server may reject mismatched amounts.

Body parameters

Field	Type	Required	Description
senderName	string	Yes	Pickup contact name
senderPhone	string	Yes	E.164 format, e.g. +265991234567
senderCity	string	Yes	Pickup city
receiverName	string	Yes	Delivery contact name
receiverPhone	string	Yes	E.164 format
receiverCity	string	Yes	Delivery city
serviceType	string	Yes	`standard` or `express`
declaredValue	number	Yes	Value of goods in MWK, for insurance purposes
amount	number	Yes	Shipping cost in MWK, from Calculate Pricing
weight	number	Yes	Package weight in kg
pricingType	string	Yes	Must be `weight_based`
description	string	Yes	Order/contents description
ecommerceOrderId	string	Yes	Your platform’s order ID, for reconciliation
shopId	string	Yes	Your shop code, provided by Impala Courier

$	curl -X POST https://api.impala-courier.com/api/public/shipments \
>	-H "X-API-Key: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"amount": 8500,
>	"shopId": "{{shopCode}}",
>	"weight": 2.5,
>	"senderCity": "Blantyre",
>	"senderName": "John Doe",
>	"description": "Order #12345 - Electronics",
>	"pricingType": "weight_based",
>	"senderPhone": "+265991234567",
>	"serviceType": "standard",
>	"receiverCity": "Lilongwe",
>	"receiverName": "Jane Smith",
>	"declaredValue": 50000,
>	"receiverPhone": "+265987654321",
>	"ecommerceOrderId": "SHOP-12345"
>	}'

1	{
2	"data": {
3	"amount": 8500,
4	"status": "pending_pickup",
5	"trackingNumber": "IMP123456789012",
6	"ecommerceOrderId": "SHOP-12345"
7	},
8	"success": true
9	}

Authentication

Headers

Request

Response