Shipment redirect

Create a shipment redirect

post

/shipments/modification/redirecting

The method allows you to create a redirect for an existing Nova Post shipment and change its delivery location without creating a new shipment.

Using this method, a shipment can be redirected:

• to a branch;
• to a parcel locker;
• to the recipient's address.

For the new delivery location, only one addressing method must be used:

• recipient.divisionId — for delivery to a branch or parcel locker;
• recipient.addressParts.street together with the other required recipient.addressParts fields — for address delivery.

🔸Do not provide recipient.divisionId and recipient.addressParts.street at the same time. If neither of these fields is provided, the request will fail validation.

After a redirect is successfully created, there is no need to create a new shipment. The redirect is applied to the existing shipment.

Authorizations

AuthorizationstringRequired

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

Body

idone ofRequired

Identifier of the existing shipment for which a redirect must be created.

It can be passed as a positive integer or UUID. For a numeric value, the minimum value is 1.

🔻This field is required.

Example: 19859866

integer · min: 1Optional

or

string · uuidOptional

payerTypestring · enumRequired

Party responsible for paying for the redirect service. Available values:

• Sender — sender;
• Recipient — recipient;
• ThirdPerson — third party.

🔻This field is required.

Possible values:

payerContractNumberstring · nullableOptional

Payer's contract number.

customerTypestring · enumOptional

Type of customer initiating the redirect. Available values:

• Recipient — recipient;
• Sender — sender.

Possible values:

customerPhonestring · nullableOptional

Customer's contact phone number.

sourcestring · enumOptional

Source from which the redirect is created.

For API integration, use the value API.

Possible values:

notestringOptional

Comment for the redirect.

🔹If there is no comment, pass an empty string.

Responses

200

Redirect successfully created.

application/json

idintegerOptional

Identifier of the created redirect.

numberstringOptional

Number of the created redirect.

shipmentIdintegerOptional

Identifier of the shipment for which the redirect was created.

shipmentnumberstringOptional

Number of the existing Nova Post shipment.

typestring · enumOptional

Type of the created modification.

For this method, Redirecting is returned.

Possible values:

statusstringOptional

Current redirect processing status.

🔹NeedProcessing means that the redirect has been created and submitted for further processing.

Example: NeedProcessing

payerTypestring · enumOptional

Party responsible for paying for the redirect service.

Possible values:

customerTypestring · enumOptional

Type of customer that initiated the redirect. Possible values:

• Recipient — recipient;
• Sender — sender.

Possible values:

notestringOptional

Comment for the redirect.

scheduledDeliveryDatestring · date-timeOptional

Scheduled delivery date and time after the redirect.

costnumberOptional

Cost of the redirect service.

currencystringOptional

Currency code of the service cost.

For example: USD.

currencySymbolstringOptional

Currency symbol.

For example: $.

401

Unauthorized

application/json

404

The shipment with the specified identifier was not found.

422

The request failed validation, or redirecting cannot be performed for the current shipment.

503

Connection time-out

application/json

post/shipments/modification/redirecting

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

{
  "id": 19859866,
  "payerType": "ThirdPerson",
  "payerContractNumber": "GNPMD-00029299",
  "customerType": "Sender",
  "source": "API",
  "note": "",
  "recipient": {
    "phone": "37123456789",
    "name": "Test Tesov",
    "countryCode": "MD",
    "divisionId": 12345,
    "addressParts": {}
  }
}

{
  "id": 9405417,
  "number": "SMUS0000205405",
  "shipmentId": 19859866,
  "shipmentnumber": "SHUS7810637809",
  "type": "Redirecting",
  "status": "NeedProcessing",
  "payerType": "ThirdPerson",
  "customerType": "Sender",
  "note": "",
  "scheduledDeliveryDate": "2026-09-27T07:55:00.000000Z",
  "cost": 3.36,
  "currency": "USD",
  "currencySymbol": "$"
}