Proof of delivery

List attachments

get

https://api-stage.novapost.com/v.1.0https://api.novapost.com/v.1.0

/shipments/{shipmentNumber}/attachments

Returns a list of available shipment-related attachment files (photos and/or signature) for the specified shipment only if the shipment belongs to the authenticated client.

🔹Description of control elements:

SCHEMA

Displays the full technical structure of the request or response, including field names, data types, required fields, allowed values, and validation rules.

• Single line description A description that fits into a single line; any text that does not fit remains hidden.

• Multiline description An expanded description that displays more than one line of text.

EXAMPLE

Shows a ready-made sample JSON with correctly formatted values to demonstrate how a valid request or response should look.

Authorizations

JWT

AuthorizationstringRequired

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

Path parameters

shipmentNumberstringRequired

Shipment`s numbers.

Example: SHDE2072834273

Responses

200

Metadata structure

application/json

shipmentIdintegerOptional

Internal ID of the shipment.

createdAtstringOptional

Date and time when the file was uploaded. Date in ISO 8601 format.

401

Unauthorized

application/json

404

The specified resource was not found

application/json

422

Possible Error Responses

application/json

503

Connection time-out

application/json

get

/shipments/{shipmentNumber}/attachments

HTTPcURLJavaScriptPython

GET /v.1.0/shipments/{shipmentNumber}/attachments HTTP/1.1
Host: api-stage.novapost.com/
Authorization: YOUR_API_KEY
Accept: */*

[
  {
    "shipmentId": 279708,
    "storageInfo": {
      "id": "c0da6fe9-997b-4f8d-b798-0150e50a6655",
      "name": "string (11).png",
      "documentType": "signature"
    },
    "createdAt": "2025-07-29T14:07:30.135738Z"
  },
  {
    "shipmentId": 279708,
    "storageInfo": {
      "id": "da2dc99f-c7e9-478d-9597-9ccca38f6bdb",
      "name": "IMG_8034.JPG.png",
      "documentType": "proofOfDelivery"
    },
    "createdAt": "2025-07-29T14:08:16.476107Z"
  },
  {
    "shipmentId": 279708,
    "storageInfo": {
      "id": "038a5340-f2a1-4982-a88b-8ad01b80bd81",
      "name": "IMG_7298.JPG.png",
      "documentType": "proofOfDelivery"
    },
    "createdAt": "2025-07-29T14:07:30.135738Z"
  },
  {
    "shipmentId": 279708,
    "storageInfo": {
      "id": "257f5a42-1c0f-48aa-9805-0af3a757b863",
      "name": "IMG_8000.JPG.png",
      "documentType": "proofOfDelivery",
      "createdAt": "2025-07-29T14:07:30.135738Z"
    }
  }
]

Download attachment

get

https://api-stage.novapost.com/v.1.0https://api.novapost.com/v.1.0

/shipments/{shipmentNumber}/attachments/{fileId}

Returns the stream of the file specified by fileId, if the shipment belongs to the authenticated client.

🔹Description of control elements:

SCHEMA

Displays the full technical structure of the request or response, including field names, data types, required fields, allowed values, and validation rules.

• Single line description A description that fits into a single line; any text that does not fit remains hidden.

• Multiline description An expanded description that displays more than one line of text.

EXAMPLE

Shows a ready-made sample JSON with correctly formatted values to demonstrate how a valid request or response should look.

Authorizations

JWT

AuthorizationstringRequired

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

Path parameters

shipmentNumberstringRequired

Shipment`s numbers.

Example: SHDE2072834273

fileIdstringRequired

Unique file identifier.

Example: 60946ff4-8170-415b-ab66-719848ef1da7

Responses

200

A file.

application/pdf

string · binaryOptional

401

Unauthorized

application/json

404

The specified resource was not found

application/json

422

Unprocessable Entity

application/json

503

Connection time-out

application/json

get

/shipments/{shipmentNumber}/attachments/{fileId}

HTTPcURLJavaScriptPython

GET /v.1.0/shipments/{shipmentNumber}/attachments/{fileId} HTTP/1.1
Host: api-stage.novapost.com/
Authorization: YOUR_API_KEY
Accept: */*

binary