Repeat Delivery

Create Repeat Delivery

post

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

/shipments/modification/repeat-delivery

This method creates a Repeat Delivery request for a shipment that is currently stored at a long-term storage warehouse (LTS).

Key rules:

• Available only for shipments currently at long-term storage (LTS).
• A maximum of 4 completed Repeat Delivery services is allowed per shipment.
• A Repeat Delivery service cannot be ordered if the shipment already has a Redirecting, Return, or Repeat Delivery request in the NeedProcessing or InProgress status.

🔹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

Body

application/json

shipmentIdintegerRequired

ID of the shipment at long-term storage.

🔻This field is required.

payerTypestring · enum · nullableOptional

Identifies who is responsible for payment of the repeat delivery service.

Allowed values:

• Sender
• Recipient
• ThirdPerson

If the field is not provided, the order creator pays for the service.

Possible values:

payerContractNumberstring · nullableOptional

Required for B2B clients (legal entities with contract payment).

notestringOptional

Any comment to the order.

Responses

200

Repeat Delivery order successfully created.

application/json

costnumberOptional

Delivery cost for the repeat delivery service.

currencystringOptional

Currency code according to ISO 4217.

currencySymbolstringOptional

Currency symbol.

scheduledDeliveryDatestring · date-timeOptional

Estimated delivery date in ISO 8601 format.

401

Unauthorized

application/json

422

Validation error.

application/json

503

Connection time-out

application/json

post/shipments/modification/repeat-delivery

HTTPcURLJavaScriptPython

POST /v.1.0/shipments/modification/repeat-delivery HTTP/1.1
Host: api-stage.novapost.com/
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 502

{
  "shipmentId": 440459,
  "payerContractNumber": "String",
  "payerType": "Sender",
  "note": "Repeat delivery to a new address",
  "recipient": {
    "name": "John Doe",
    "phone": "37360123456",
    "email": "[e-mail]",
    "companyTin": "38130410",
    "companyName": "String",
    "countryCode": "MD",
    "eoriCode": null,
    "settlementId": null,
    "divisionId": null,
    "address": {},
    "addressParts": {
      "postCode": "1345",
      "building": "3",
      "street": "Mircea cel Batrin",
      "city": "Chișinău",
      "region": "Chișinău",
      "flat": "",
      "note": "Near central park",
      "block": ""
    }
  }
}

{
  "cost": 69,
  "currency": "MDL",
  "currencySymbol": "",
  "scheduledDeliveryDate": "2026-03-31T15:00:00.000000Z"
}

Cancel Repeat Delivery

delete

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

/shipments/modification/repeat-delivery/delete/{shipmentID}

The method cancels the current active Repeat Delivery request associated with the specified shipment.

Use this method when you need to cancel a repeat delivery request that has not yet been processed. Cancellation is available only while the repeat delivery order is still being processed.

Key rules:

• Cancellation is available only while the repeat delivery order is still being processed.
• Once a repeat delivery has been completed, it cannot be cancelled.

🔹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

shipmentIDintegerRequired

The ID of the shipment for which the Repeat Delivery order should be cancelled.

Example: 440459

Responses

200

Repeat Delivery order successfully cancelled. Returns the cancellation timestamp.

application/json

deletedAtstringRequired

Timestamp when the Repeat Delivery order was cancelled.

Pattern: ^20[0-9]{2}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}.[0-9]{6}Z$

422

Unprocessable Entity. The cancellation cannot be processed.

application/json

delete/shipments/modification/repeat-delivery/delete/{shipmentID}

HTTPcURLJavaScriptPython

DELETE /v.1.0/shipments/modification/repeat-delivery/delete/{shipmentID} HTTP/1.1
Host: api-stage.novapost.com/
Authorization: YOUR_API_KEY
Accept: */*

{
  "deletedAt": "2026-06-08T15:15:33.043730Z"
}