Print documents

Print Shipment Documents

get

/shipments/print

This API method allows you to retrieve a transportation document marking in PDF format by providing the document number. The document marking is a printable document that clients can attach or affix to their cargo when sending it. By specifying the document number in the request, you can generate a PDF file containing the document marking for easy printing.

Authorizations

AuthorizationstringRequired

Authorization JWT-token with a lifetime of 1 hour in header

Query parameters

numbers[]stringOptional

Shipment numbers. Can accept either a single number or an array of numbers. When type=marking is used, only one number is allowed per request.

Example: SHPL1234567890

typearray · enumOptional

Type of document to be printed.

• marking: for shipment marking labels (100x100, 100x150, or other formats depending on the shipment)
• international: for customs declaration/invoice
• invoice: for commercial invoice

Possible values:

printSizeTypearrayOptional

Selection of document size.

For type=marking, this parameter defines the marking print request type, but does not guarantee the final physical PDF format returned by the service.

The final label format is determined automatically according to the created shipment.

If not provided:

• type=marking uses the internal marking print logic;
• type=international and type=invoice use size_A4 by default.

Backward compatibility for 100_100 and size_100_100 values is preserved.

deliveryTypestring · enumOptional

Type of delivery flow for marking document printing. Applicable only for type=marking.

• Pickup: first mile
• Shipment: last mile

Possible values:

Responses

200

A PDF file.

application/pdf

string · binaryOptional

401

Unauthorized

application/json

404

The specified resource was not found

application/json

422

Validation error

application/json

503

Connection time-out

application/json

get/shipments/print

GET /v.1.0/shipments/print HTTP/1.1
Host: api-stage.novapost.com/
Authorization: YOUR_API_KEY
Accept: */*

binary