Skip to Content
dzshipBY DZBUILD

dzship documentation

dzship is a free HTTP API that creates, tracks and prices cash-on-delivery parcels with 99 Algerian couriers. No signup and no API key.

dzship is one HTTP API in front of 99 Algerian delivery couriers: Yalidine, ZR Express, Maystro, NOEST, Zimou and every courier that runs on Ecotrack. You send the same JSON whichever courier you ship with, and you get the same response back.

There is no signup and no API key. Each request carries your own credentials for the courier you named. They are used for that one call and never stored, and the parcel is created on your own courier account.

One request shape

Every call is a courier key, that courier's credentials, and the payload of the operation.

create-order.sh
curl -X POST https://freeship.dzbuild.com/v1/orders \
  -H 'Content-Type: application/json' \
  -d '{
    "courier": "yalidine",
    "credentials": { "apiId": "YOUR_API_ID", "apiToken": "YOUR_API_TOKEN" },
    "options": { "fromWilaya": 16 },
    "order": {
      "recipient": {
        "fullName": "Amine Bouzid",
        "phone": "0551234567",
        "wilayaCode": 16,
        "communeName": "Bab Ezzouar"
      },
      "deliveryType": "home",
      "productList": "Sneakers Air x1",
      "codAmount": 4500
    }
  }'

Change courier and credentials to ship with another courier. Nothing else in the request moves.

No courier account yet?

"courier": "sandbox" needs no credentials. It validates the phone, the wilaya, the commune and every field limit the way a real courier does, and creates no parcel. The quickstart starts there.

What you can call

EndpointWhat it does
POST /v1/ordersCreate a parcel on your courier account
POST /v1/trackStatus and full event history for a tracking number
POST /v1/ratesDelivery and return fees for a route
POST /v1/desksThe stop desks a courier runs in one wilaya
GET /v1/couriersEvery supported courier, its credentials and capabilities
GET /v1/wilayasThe 58 wilayas couriers deliver to (?all=1 for all 69)
GET /v1/communesAll 1,541 communes, filterable by wilaya

The endpoints guide explains each one with its fields, errors and rate limits. The API reference is the same contract generated from /openapi.json, with a request builder on every page.

Where to go next

Call it from a server

Courier credentials create parcels and read customer data on your account. Keep them on your backend, never in browser JavaScript or a mobile app.

Who runs it

dzship is operated by DZBuild, an e-commerce platform for Algerian merchants. The courier integrations behind this API are the ones DZBuild stores ship with. The guides, the clients and the wilaya dataset are public on GitHub.

Last updated on

On this page