Get sale fulfilment

Returns the fulfilment opened for a sale.

GEThttps://api.tracksales.co/v1/sales/{uuid}/fulfilment

Create the sale with POST /sales first, using salesChannel online. Then call this endpoint with the sale uuid from that response. A new fulfilment is saved with status draft, which the fulfilment screen shows as Awaiting dispatch. Calling create again for the same sale returns the existing fulfilment.

Required scope: fulfilments:read

Request URL: https://api.tracksales.co/v1/sales/{uuid}/fulfilment

Path Params

uuidstringrequired

Sale UUID returned by Create sale

Responses

200OK

Request succeeded.

401Unauthorized

API key is missing or invalid.

403Forbidden

API key lacks the required scope.

404Not Found

Fulfilment was not found.

422Validation Error

Request validation failed.

curl -X GET 'https://api.tracksales.co/v1/sales/{uuid}/fulfilment' \
  -H 'Authorization: Bearer ts_live_YOUR_API_KEY' \
  -H 'Accept: application/json'

{
    "success": true,
    "data": {
        "id": "990e8400-e29b-41d4-a716-446655440088",
        "deliveryNumber": "DL-00018",
        "status": "draft",
        "statusName": "Awaiting dispatch",
        "saleId": "880e8400-e29b-41d4-a716-446655440099",
        "fulfilmentType": "delivery",
        "deliveryAddress": "Moktar Dadah Street, Nairobi",
        "deliveryZone": "CBD & Central",
        "notes": "Esmanda order ESM-1042",
        "items": [
            {
                "itemId": "101",
                "name": "Widget A",
                "quantity": 2
            }
        ]
    }
}

{
    "success": false,
    "error": {
        "code": "unauthenticated",
        "message": "Invalid or revoked API key."
    }
}

{
    "success": false,
    "error": {
        "code": "forbidden",
        "message": "API key lacks required scope."
    }
}

{
    "success": false,
    "message": "Fulfilment not found"
}

{
    "success": false,
    "message": "Validation failed",
    "errors": {
        "field": [
            "The field is required."
        ]
    }
}