1. Packages
  • Overview
  • Packages
    • Create a shipment
      POST
    • Generate an AWB PDF for one or more packages
      POST
    • Get a package's current status
      GET
    • Get a package's full status history
      GET
    • List the possible package statuses
      GET
    • Cancel a package
      PUT
    • Return a package to sender
      PUT
    • List the company's service types
      GET
    • Calculate a shipment's delivery cost
      POST
    • List the company's vehicle types
      GET
    • List the company's parcel types
      GET
  • Webhooks
    • Package Status Webhook
  • Addresses
    • List the company's address book
      GET
    • List regions
      GET
    • List a region's cities
      GET
    • List a city's villages
      GET
    • List villages
      GET
  • Schemas
    • NoteMessage
    • AddressDto
    • IntegrationPackageRequestDto
    • ParcelType
    • IntegrationAddressDto
    • CitiesTripsTimeSchedule
    • IntegrationShipmentDto
    • CreatingPackageDto
    • MainCitiesTripsTimeSchedule
    • PackageItemsToDeliver
    • PackageIdentifiersWrapper
    • Address
    • LocalizedKeyData
    • CodChangeRequest
    • PackageStatusResponse
    • Customer
    • CustomerPromo
    • GeofenceData
    • CustomersPaymentTypes
    • DeliveryPaymentType
    • Device
    • DriverFailFollowUp
    • LabelConditionDto
    • LabelDto
    • LclSupplier
    • LenDetails
    • Location
    • MandatoryPackageFieldsConfig
    • NamedObject
    • NoteMessageInfo
    • Package
    • PackageApprovalFail
    • PackageApprovalPostpone
    • PackageApprovalReturn
    • PackageContent
    • PackageContentItem
    • PackageDevice
    • PackageFailure
    • PackageItem
    • PackageLocationMessage
    • PackageTrackingNodeMessage
    • PackageTrackingStatusCount
    • PalShipRole
    • PartnerConfigDto
    • PartnerDto
    • PostponePackageMessageInfo
    • Product
    • ProductExpiryBatchLot
    • ProductVariant
    • ProductVariantOption
    • ServiceType
    • SmsGateway
    • SubPackage
    • User
    • UserAttachmentsDto
    • Vehicle
    • VehicleType
    • GetPackageCostMessage
    • JettShippingRate
    • JettShippingRateDetails
    • NameAndIdDto
    • Region
    • City
    • Village
    • ModelTableMessageVillage
    • MoneyInfoDto
  1. Packages

Create a shipment

POST
/secure/integration/packages
Creates a package for the customer that owns this API key. There is no email/password or company-id to send — both are resolved from the key. The shipment fields, originAddress and destinationAddress all go directly in the request body. If originAddress is omitted, the customer's own address is used. The service type is always STANDARD. The delivery cost is always calculated from the customer's shipping rates.
Addresses — identify the location with any one of villageId, cityId, village (name) or city (name), or send several. Missing ids are filled in automatically.
Minimal example:
{
  "receiverName": "Ahmad Ali",
  "receiverPhone": "0599999999",
  "shipmentType": "COD",
  "cod": 100,
  "destinationAddress": {
    "addressLine1": "King Fahd Road, Building 12",
    "city": "Riyadh"
  }
}

Request

Authorization
API Key
Add parameter in header
X-API-Key
Example:
X-API-Key: ********************
or
Body Params application/jsonRequired

Examples

Responses

🟢200OK
*/*
Package created
Body*/*

🟠400Bad Request
🟠401Unauthorized
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://apisv5.logestechs.com/api/secure/integration/packages' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "receiverName": "Ahmad Ali",
    "receiverPhone": "0599999999",
    "shipmentType": "COD",
    "cod": 100,
    "destinationAddress": {
        "addressLine1": "King Fahd Road, Building 12",
        "city": "Riyadh"
    }
}'
Response Response Example
200 - Example 1
{}
Modified at 2026-10-04 08:19:33
Previous
Overview
Next
Generate an AWB PDF for one or more packages
Built with