GET /orders/{orderNumber}/awb — Download Order AWB PDF

Use this endpoint to download the printable Air Waybill (AWB) shipping label for an order. Print the label and affix it to the package before handing it to the courier. The response is a binary PDF — not JSON.

Authentication

Requirement	Value
API key	Required (`Authorization: Bearer nsk_live_...`)
Scope	`orders`
`X-Merchant-Id`	Required for company keys

Path parameter

Parameter	Type	Description
`orderNumber`	string	The 6-digit order number (e.g. `482917`) returned when the order was created.

Query parameter

string

Label paper size. Accepted values: A4 or A5. Default: A4.

Choose A5 if you are printing on a dedicated thermal or label printer. Use A4 for standard office printers.

Request

Use the -o flag in curl to save the binary response directly to a file:

curl "https://now.com.eg/api/public/v1/orders/482917/awb?size=A4" \
  -H "Authorization: Bearer nsk_live_YOUR_KEY" \
  -H "X-Merchant-Id: shop_123" \
  -o awb-482917.pdf

To download an A5-sized label:

curl "https://now.com.eg/api/public/v1/orders/482917/awb?size=A5" \
  -H "Authorization: Bearer nsk_live_YOUR_KEY" \
  -H "X-Merchant-Id: shop_123" \
  -o awb-482917-a5.pdf

Response

200 — PDF binary

The response body is the raw PDF file. The Content-Type header is application/pdf.

Header	Value
`Content-Type`	`application/pdf`
`Content-Disposition`	`attachment; filename="awb-{orderNumber}.pdf"`

Do not attempt to parse the AWB response as JSON. Pass it directly to a file stream, a PDF renderer, or a print queue.

Handling the binary in code

Node.js
Python

const fs = require('fs');
const https = require('https');

const options = {
  hostname: 'now.com.eg',
  path: '/api/public/v1/orders/482917/awb?size=A4',
  headers: {
    'Authorization': 'Bearer nsk_live_YOUR_KEY',
    'X-Merchant-Id': 'shop_123',
  },
};

const file = fs.createWriteStream('awb-482917.pdf');
https.get(options, (res) => res.pipe(file));

import requests

response = requests.get(
    "https://now.com.eg/api/public/v1/orders/482917/awb",
    params={"size": "A4"},
    headers={
        "Authorization": "Bearer nsk_live_YOUR_KEY",
        "X-Merchant-Id": "shop_123",
    },
)

with open("awb-482917.pdf", "wb") as f:
    f.write(response.content)

Error responses

HTTP status	Code	Cause
`401`	`UNAUTHORIZED`	API key is missing, invalid, or revoked.
`403`	`SCOPE_DENIED`	API key does not have the `orders` scope.
`403`	`MERCHANT_REQUIRED`	Company key used without `X-Merchant-Id`.
`403`	`MERCHANT_NOT_FOUND`	The merchant ID in `X-Merchant-Id` is not linked to your company.
`404`	`NOT_FOUND`	No order with the given `orderNumber` was found.

System

Merchants

Fees

Orders

Pickups

Reference

GET /orders/{orderNumber}/awb — Download Order AWB PDF

Authentication

Path parameter

Query parameter

Request

Response

200 — PDF binary

Handling the binary in code

Error responses

​Authentication

​Path parameter

​Query parameter

​Request

​Response

​200 — PDF binary

​Handling the binary in code

​Error responses

Authentication

Path parameter

Query parameter

Request

Response

200 — PDF binary

Handling the binary in code

Error responses