DOCUMENTATION FOR OPEN APPLICATION PROGRAMMING INTERFACE OF THE UNISEND (LPEXPRESS)

1. Overview

1.1. Updates & Announcements

USA: Requirements for shipments

For shipments to the USA, the following requirements apply:

  • Additional contract agreement.
  • User consent to pay customs duty and administration fees.
  • In Self-Service, API v2 users must edit their profile and check “I agree to pay customs duty and commission fee” (one-time action).
  • If consent is given → users can create shipments to the USA via API v2 and Self-Service.
  • If not → shipments to the USA are blocked, except for “documents only,” which can be created without customs declaration.
  • Users can check duty fee amounts using the new duty/estimate/price and existing shipping/estimate/price endpoints.
See request examples
USA: Duty Fee & Full Shipping Cost Endpoints (incl. Customs & Administration Fees)

New ways to calculate costs are now available:

  • Retrieve only customs duty and administration fees via duty/estimate/price.
  • Retrieve full shipping cost including customs duty and administration fees via shipping/estimate/price
See request examples
Mandatory HS Code & Country of Origin in documents.cn.parts

In the Create Parcel request, fields in documents.cn.parts become required:

  • hsCode — 6, 8, or 10 digits
  • countryCode — country of origin

Effective dates

  • USA shipments: required now
  • All other non-EU destinations: required from 2025-12-15

See request examples
International S/M parcels: use "Tracked" — from 2025-12-15 "Signed" only for documents.

Starting 15 December 2025, the Registered Correspondence ("Signed") service (S and M sizes) will remain available only for sending documents.

This restriction applies to all international destinations.

Within Lithuania, the service will continue to be available without changes.

See request examples
New Service: Insurance for "Tracked" Plan

Starting 2025-12-15, the "Tracked" shipping plan will include an option to add Insurance for your parcels.

See request examples
Mandatory Description for EU Shipments

When sending parcels to EU countries, it is now required to provide a detailed description of the parcel contents.

Origin Destination Description Required

LT

LT

❌ No

LT

Other EU countries

✅ Yes

LV

LV

❌ No

LV

Other EU countries

✅ Yes

EE

EE

❌ No

EE

Other EU countries

✅ Yes

The shipment description must be provided in the parcel.content.items[].summary field.

See request examples
Order a return service (generates an additional label for sending the parcel back)

When adding the PRODUCT_RETURN service in the services object during parcel creation, an additional return label will be generated. This return label will be provided together with the original parcel label.

You can create return labels by submitting one or multiple original shipment barcodes. A return barcode is generated for each.

Availability:
Applicable for shipping plans H2H, T2H, T2T, H2T, H2P
Valid only for shipments between the Baltic countries (LT, LV, EE)

To enable return label generation for your shipments, please contact your sales manager.

See request examples

1.2. Getting started!

This documentation provides all the basic information you need to start using the UNISEND (LP EXPRESS) API. It covers not only how to find streets, building, localities, addresses and buildings in Lithuania but as well how to create a shipping item, how to manage all the process of sending it from start to the end by calling the courier and creating required documents for the shipment.

We offer a TEST environment of UNISEND (LP EXPRESS) which mimics the PRODUCTION environment, so developers who integrate the public UNISEND (LP EXPRESS) API to their application can experiment and test the product without any consequences.

Note: At this step you already have to have authentication to the TEST environment. We will provide you with the authentication to the PRODUCTION environment when you will be done with the integration in the TEST environment and all your needs have been reached ensuring that everything is working as it should.

All the communication with the API must be authenticated. Only authenticated request will be authorized. See Authorization page for detailed information about used security.

One of the most important function of this API is to let the user create, manage and send an item by creating it, adding required documents, calling the courier and tracking it. The processes of doing so are visualized bellow. As well find all the needed API methods and data structures for creating a request for the API.

Note: As well we are giving you a base requests collection for POSTMAN, which will help you with trying out the test environment of the API. All the needed actions to do are:

  1. Use(POST): Authorization(Without client secret) script. In the params tab add your credentials.

  2. You will get a response which will contain access token. Add it to your collection, select: View more actions → Edit →Authorization→Token

Note: another alternative to test API is a Swagger running on our side.

JaTxMAAAAASUVORK5CYII=

Click to test API in Swagger environment

B2+PFQJRofYbAAAAAElFTkSuQmCC

Click to download the POSTMAN requests collection

1.3. Authorization

  1. Authorization

    Authorization of the users of the application programming interface uses the OAuth2 login standard. More information at https://tools.ietf.org/html/rfc6749

    Important for API integrations: Use a non-browser User-Agent in all server-to-server requests. Requests with browser-like values (for example, Mozilla or Chrome) are treated as web traffic and are automatically blocked by our firewall.

    wdpMYg30+b1sgAAAABJRU5ErkJggg==

  2. Getting started to use API
    Contact before api-manosiuntos@post.lt authorizing to API, we need to make configuration on our side.

    1. Getting access/refresh token

      hxgAAAAASUVORK5CYII=

    2. Sample request to get access token:

      Tip: Pass API_CLIENT scope to test API access.

      curl --location --request POST 'https://<hostname>/oauth/token?grant_type=password&username=<username>&password=<password>&scope=read%2Bwrite%2BAPI_CLIENT'

      Sample response:

                                                              {
                                                        "access_token": "XXXX-XXXX-XXXX-XXXX-XXXX",
                                                        "refresh_token": "YYYY-YYYY-YYYY-YYYY-YYYY",
                                                        "scope": "read write",
                                                        "token_type": "Bearer",
                                                        "expires_in": 2591999
                                                        }

    3. Sample request to get refresh token:

      curl --location --request POST 'https://<hostname>/oauth/token?grant_type=refresh_token&refresh_token=YYYY-YYYY-YYYY-YYYY-YYYY'

      Sample response:

                                                              {
                                                        "access_token": "XXXX-XXXX-XXXX-XXXX-XXXX",
                                                        "refresh_token": "YYYY-YYYY-YYYY-YYYY-YYYY",
                                                        "scope": "read write",
                                                        "token_type": "Bearer",
                                                        "expires_in": 2591999
                                                        }

      When you receive the access token, it have included a refresh token as well as an expiration time. The “expires_in” value is the number of seconds that the access token will be valid. Access tokens can expire for many reasons, such as the user revoking an app, or if the authorization server expires all tokens when a user changes their password.

      If you make an API request and the token has expired already, you’ll get back a response indicating 401 error.

      You can check for this specific error message, and then refresh the token and try the request again. When your application recognizes this specific error, it can then make a request to the token endpoint using the refresh token it previously received, and will get back a new access token it can use to retry the original request.

      The “expires_in” property refers to the access token, not the refresh token. The expiration time of the refresh token is intentionally never communicated to the client. This is because the client has no actionable steps it can take even if it were able to know when the refresh token would expire. There are also many reasons refresh tokens may expire prior to any expected lifetime of them as well.

    4. Important: after 5 times invalid authentifications account will be blocked for 15 minutes.

2. Shipping item creation and management process

General overview of API shipping workflow

L0U8o+8vU8VVQfrALAQjYTQDBbXf9iN4uAj9S4da2K2SihQAEPBCQC10EtwdQLIFAUgkguJNaefIuBoH6yun3i+EYnxCAQKAEpIO+UR2BddIDjR7jEIBA4AT+P+iMTh+eA+x3AAAAAElFTkSuQmCC

2.1. Step-by-Step example.

0. Estimate parcel data

Consider that we need to send a package to the recipient's address within Lithuania by dispatching the package from parcel locker.

Based on the table in the 2.2. Plan codes section, we find that the T2H plan type and the HANDS plan code match the shipping method we require (from the parcel locker to the recipient's address).

You can find more details about plans, shipping rates, available services, and other information using the EstimateShippingOperations methods:

curl --location --request GET '/api/v2/shipping/estimate/plan?receiverCountryCode=LT&senderCountryCode=LT'

1. Parcel creation step

curl --location --request POST '/api/v2/parcel'
Request Body 
                            
                                {
                                    "plan": {
                                      "code": "HANDS"
                                    },
                                    "parcel": {
                                      "type":"T2H",
                                      "size":"S"
                                    },
                                    "receiver": {
                                      "name": "test name",
                                      "companyName": "test lastName",
                                      "address": {
                                          "countryCode": "LT",
                                          "locality":"Vilnius",
                                          "postalCode": "08247",
                                          "street": "Juozo Balčikonio g.",
                                          "building": "3"
                                      },
                                      "contacts":{
                                          "phone":"+37000000000",
                                          "email": "test@test.lt"
                                      }
                                    }
                                  }
Request Body by idRef* 
                            
                                {   
                                    "idRef": "YOUR_ORORDER_ID_123",
                                    "plan": {
                                      "code": "HANDS"
                                    },
                                    "parcel": {
                                      "type":"T2H",
                                      "size":"S"
                                    },
                                    "receiver": {
                                      "name": "test name",
                                      "companyName": "test lastName",
                                      "address": {
                                          "countryCode": "LT",
                                          "locality":"Vilnius",
                                          "postalCode": "08247",
                                          "street": "Juozo Balčikonio g.",
                                          "building": "3"
                                      },
                                      "contacts":{
                                          "phone":"+37000000000",
                                          "email": "test@test.lt"
                                      }
                                    }
                                  }

* The "idRef" parameter acts as a unique identifier for parcels in the system, allowing for simplified management by referencing a user-specified value instead of system-generated parcelId.

Response Body 
                            
                                {
                                    "parcelId": 3499918,
                                    "warnings": []
                                }

2. Parcel update step

If corrections need to be made, such as correcting the address, plan, size, weight, services and etc., you can update the parcel by simply resending the request with the new information, specifying the parcelId obtained in the response from the previous step.

curl --location --request PUT '/api/v2/parcel/{parcelId}'

or, if you use idRef:

curl --location --request PUT '/api/v2/parcel/idref/{idRef}'
Request Body 
                            
                                {
                                    "plan": {
                                      "code": "HANDS"
                                    },
                                    "parcel": {
                                      "type":"T2H",
                                      "size":"S"
                                    },
                                    "receiver": {
                                      "name": "test name",
                                      "companyName": "test lastName",
                                      "address": {
                                          "countryCode": "LT",
                                          "locality":"Vilnius",
                                          "postalCode": "08247",
                                          "street": "Juozo Balčikonio g.",
                                          "building": "5"
                                      },
                                      "contacts":{
                                          "phone":"+37000000000",
                                          "email": "test@test.lt"
                                      }
                                    }
                                  }

3. Initiate step

When the parcel is successfully prepared, you can complete the shipment creation process and initiate it.

curl --location --request POST '/api/v2/shipping/initiate'
Request Body 
                            
                                {"parcelIds": [{{parcelId}}]}
Request Body by idRef 
                            
                                {"idRefs": [{{IdRef}}]}
Response Body 
                            
                                {
                                    "requestId": "04d811ee-6b97-3778-95bd-ed123021001c"
                                }

4. Get shipping order status

To ensure the successful creation of the shipment and obtain its tracking number, you can utilize the requestId obtained after initiating the shipment in the previous step.

curl --location --request GET '/api/v2/shipping/status/{requestId}'
Response Body 
                            
                                {
                                    "status": "SUCCESSFUL",
                                    "items": [
                                        {
                                            "barcode": "CH800063274LT",
                                            "parcelId": 3499918,
                                            "status": "OK",
                                            "trackable": true
                                        }
                                    ]
                                }

5. Print sticker step

Generate a sticker in PDF format for the created shipment using the parcelId obtained in Step 1. *

curl --location --request GET '/api/v2/sticker/pdf?parcelIds={{parcelId}}&layout=LAYOUT_10x15'

or, if you use idRef:

curl --location --request GET '/api/v2/sticker/pdf?idRefs={{idRefs}}&layout=LAYOUT_10x15'

* Please note that this is a simple example, and there are additional options available to tailor shipment generation to your specific needs and scenarios. You can customize parameters accordingly; detailed information is available in the provided documentation.

2.2. Plan codes

Types planCodes size Directions Tracking Description

P2H
API request example

UNTRACKED

XS(Letter) weight 1-50 g

LT ➜ Any

no

Shipment from the post office to the receiver’s address/post office

S (SmallCorrespondence) weight 1-500 g

LT ➜ Any

M (MediumCorrespondence) weight 1-2000 g

LT ➜ Foreign Only

TRACKED

S (SmallCorrespondence) weight 1-500 g

LT ➜ Foreign Only

yes

Shipment from the post office to the receiver’s address without a signature

M (MediumCorrespondence) weight 1-2000 g

LT ➜ Foreign Only

SIGNED

XS (Letter) weight 1-50 g (Documents Only)

LT ➜ Any

Only in LT

Shipment from the post office to the receiver’s address/post office with signature

S (SmallCorrespondence) weight 1-500 g (Documents Only)

LT ➜ Any

M (MediumCorrespondence) weight 1-2000 g (Documents Only)

LT ➜ Any

L (Parcel) weight 1-30000 g

LT ➜ Any

PROCESSES_DOCUMENTS

No size (weigth 1-5000g)

LT ➜ LT

yes

Shipment from the post office to the receiver’s address/post office with signature

H2H
API request example

HANDS

No size max weight by contract

LT ➜ Any
LV ➜ LV, LT, EE
EE ➜ EE, LT, LV

yes

Shipment from sender/pickup address delivered by UNISEND (LP EXPRESS) courier to the receiver’s address

T2H

XS, S, M, L, XL weight 1-30000 g

LT ➜ LT, LV, EE
LV ➜ LV, LT, EE
EE ➜ EE, LT, LV

yes

Shipment from UNISEND(LP EXPRESS) self-service terminal/ locker, delivered by UNISEND (LP EXPRESS) courier to the receiver’s address

T2T
API request example

TERMINAL

XS, S, M, L, XL weight 1-30000 g

LT ➜ LT, LV, EE
LV ➜ LV, LT, EE
EE ➜ EE, LT, LV

yes

Shipment from and to UNISEND (LP EXPRESS) self-service terminal/ locker.

H2T

Shipment from sender/pickup address delivered to UNISEND (LP EXPRESS) self-service terminal/ locker.

T2S

Shipment from and to UNISEND (LP EXPRESS) self-service terminal/ locker within 72 hours

H2P

TRACKED_SIGNED

No size (weigth 1-10000g)

LT ➜ LT

yes

Shipment from sender/pickup address delivered to the receiver’s post office

H2F
API request example

HANDS_EXPRESS

Only foreign

LT, LV, EE ➜ Austria, Belgium, Czech Republic, Denmark, Finland, France, Germany, Hungary, Ireland, Italy, Luxembourg, Netherlands, Poland, Slovenia, Spain, Sweden. Greece , Portugal . Cyprus , Malta , Slovakia, Bulgaria, Rumunia, Croatia

yes

Shipment from sender/pickup address delivered by Express courier to the receiver’s address

2.3. ParcelOperations

2.3.1. create

POST /api/v2/parcel

Create parcel

Please note that with this method, you only create a parcel. To clarify, you add the shipment data to the cart, but you do not complete the shipment creation process. In order for the parcel to be ready for shipment and to complete the creation process, it must be initiated. The shipping initiation method is described in the "initiateShipping" section.
Description

Creates single parcel item.

Parameters
Body Parameter
Field Name Size Required Type Description

comment

string(128)

String

Comment or additional notes about the shipment.

idRef

string(255)

String

The "idRef" is your own ID for the parcel, which you can set when creating it. Later, you can use this ID to find, edit, or manage the parcel without needing the system's parcel ID.

plan

X

PlanRequest

Shipping plan details.

plan.code

X

String

Shipping plan code (e.g., 'HANDS').

parcel

X

ParcelRequest

Parcel details.

parcel.type

X

String

Parcel type (e.g., 'H2H').

parcel.size

String

Size of the parcel (e.g., 'XS').

parcel.weight

Optional only for TERMINAL planCode shipments

Number

Weight of the parcel in grams.

HANDS_EXPRESS - Volumetric weight (L×W×H / 5000) must not exceed 30 kg.

parcel.partCount

Integer

Number of parts or packages. Only for H2H and H2P plan types.

parcel.document

Boolean

Indicates if parcel includes documents.

receiver

X

PersonRequest

Recipient information.

receiver.name

string(100)

X

String

Recipient's name.

receiver.companyName

String

Recipient's company name.

receiver.contacts.phone

Phone Number Requirement Rules

String

Recipient's phone number.
Phone Number Validation Rules

receiver.contacts.email

string(128)

String

Recipient's email address.

receiver.contacts.fax

String

Recipient's fax number.

receiver.address

X

AddressRequest

Recipient's address details.

sender.name

X

String

Recipient's name.

sender.companyName

String

Recipient's company name.

sender.contacts.phone

X

String

Recipient's phone number.
Phone Number Validation Rules

sender.contacts.email

String

Recipient's email address.

sender.contacts.fax

String

Recipient's fax number.

sender.address

X

AddressRequest

Recipient's address details.

pickup.name

X

String

Recipient's name.

pickup.companyName

String

Recipient's company name.

pickup.contacts.phone

X

String

Recipient's phone number.

pickup.contacts.email

String

Recipient's email address.

pickup.contacts.fax

String

Recipient's fax number.

pickup.address

X

AddressRequest

Recipient's address details.

documents.cn

DocumentRequest

Customs CN22/23 documentation for international shipments.

documents.cn.contentType

X

String

Type of contents (e.g., SAMPLE, OTHER, GIFT, RETURN, SELL, DOCUMENT).

documents.cn.contentDescription

String

Detailed content description.

documents.cn.failureInstruction

String

Instruction if delivery fails.

documents.cn.importer.taxCode

String

Importer’s tax code.

documents.cn.importer.vatCode

String

Importer’s VAT code.

documents.cn.importer.contact.phone

String

Importer's contact phone number.

documents.cn.exporter.customsRegistrationNo

String

Exporter customs registration number.

documents.cn.parts[].summary

X

String

Item summary.
Max input length: 256 characters
Displayed on label: up to 64 characters

documents.cn.parts[].weight

X

Number

Item weight.

documents.cn.parts[].quantity

X

Integer

Item quantity.

documents.cn.parts[].hsCode

X

Integer

6, 8, or 10 digits

documents.cn.parts[].amount

X

Number

Item amount.

documents.cn.parts[].currencyCode

X

String

Currency code of the declared value. Only EUR and USD are supported.

documents.cn.parts[].countryCode

X

String

Country of origin.

services

List of BasicService

Optional service list with code and value.

services[].code

X

String

Service code.

services[].value

X

String

Service value (optional).

senderAddressId

Long

Saved sender address ID.

pickupAddressId

Long

Saved pickup address ID.

parcel.content

ContentRequest

Required for EU shipments

parcel.content.items

X

Array

List of content items.

parcel.content.items[].summary

X

String

Description of the item.
Max input length: 256 characters
Displayed on label: up to 64 characters

parcel.content.items[].quantity

X

Integer

Quantity of the item.

parcel.content.items[].amount

X

Number

Declared value of the item.

dimensions

Array

Only for HANDS_EXPRESS shipments to declare parcel dimensions.

Minimum size: 18 cm x 10 cm x 5 cm (per HANDS_EXPRESS requirements, for each parcel part)
Maximum size: No side can be longer than 105 cm

dimensions.length

X

Integer

HANDS_EXPRESS Parcel length

dimensions.width

X

Integer

HANDS_EXPRESS Parcel width

dimensions.height

X

Integer

HANDS_EXPRESS Parcel height
Return Type

ParcelCreateResponse

Content Type

  • application/json

Responses
Table 1. HTTP Response Codes
Code Message Datatype

200

Parcel ID and list of warnings if any exists

ParcelCreateResponse

400

Bad Request

FieldErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

Samples
Example request: Parcel locker to Parcel locker 
                                
                                    {
                                        "plan": {
                                          "code": "TERMINAL"
                                        },
                                        "parcel": {
                                          "type":"T2T",
                                          "size": "S"
                                        },
                                        "receiver": {
                                          "name": "Test Name",
                                          "companyName": "Test lastName",
                                              "address" : {
                                                  "countryCode": "LT",
                                                  "locality": "Vilnius",
                                                  "terminalId": "0137"
                                      },
                                          "contacts":{
                                              "phone":"+37000000000"
                                          }
                                        }
                                      }
Example request: Courier to Parcel Locker 
                                
                                    {
                                        "plan": {
                                          "code": "TERMINAL"
                                        },
                                        "parcel": {
                                          "type":"H2T",
                                          "size": "XS"
                                        },
                                        "receiver": {
                                          "name": "Test Name",
                                          "companyName": "Test lastName",
                                              "address" : {
                                                  "countryCode": "LT",
                                                  "terminalId": "0137"
                                      },
                                          "contacts":{
                                              "phone":"+37000000000"
                                          }
                                        }
                                      }
Example request: Courier to Receiver address 
                                
                                    {
                                        "plan": {
                                          "code": "HANDS"
                                        },
                                        "parcel": {
                                          "type":"H2H",
                                          "weight":"9000"
                                        },
                                        "receiver": {
                                          "name": "Test Name",
                                          "companyName": "Test lastName",
                                          "address": {
                                            "countryCode": "LT",
                                            "locality":"Vilnius",
                                            "postalCode": "08247",
                                            "street": "Juozo Balčikonio g.",
                                            "building": "3"
                                        },
                                          "contacts":{
                                              "phone":"+37000000000",
                                              "email": "test@post.lt"
                                          }
                                        }
                                      }
Example request: TRACKED parcel with HS Code and Country of Origin in CN declaration 
                                
                                    {
                                    "plan": {
                                        "code": "TRACKED"
                                    },
                                    "parcel": {
                                        "type":"P2H",
                                        "size":"M",
                                        "weight":"2000"
                                    },
                                        "services": [
                                        ],
                                        "receiver": {
                                            "name": "test name",
                                            "address": {
                                                "countryCode": "US",
                                                "locality": "Dallas, Texas",
                                                "postalCode": "75231",
                                                "street": "Maple Ridge Dr",
                                                "building": "7428",
                                                "flat": "5"
                                            },
                                            "contacts": {
                                                "email": "test@post.lt",
                                                "phone": "4695550172"
                                            }
                                        },
                                        "documents": {
                                        "cn": {
                                            "contentType": "sell",
                                            "parts": [
                                            {
                                                "summary": "Laptop Asus Vivobook",
                                                "amount": "700.95",
                                                "currencyCode": "EUR",
                                                "weight": 2000,
                                                "quantity": 1,
                                                "hsCode": 84713010,
                                                "countryCode": "CN"
                                            }
                                            ]
                                        }
                                        }
                                    }
Example request: Mandatory Description for EU Shipments. 
                                
                                    {
                                    "plan": {
                                        "code": "HANDS"
                                    },
                                    "parcel": {
                                        "type": "H2H",
                                        "weight": "400",
                                        "content": {
                                            "items": [
                                                {
                                                    "summary": "Book",
                                                    "quantity": 1,
                                                    "amount": 50
                                                }
                                            ]
                                        }
                                    },
                                    "receiver": {
                                        "name": "Receiver FI",
                                        "address": {
                                            "countryCode": "FI",
                                            "locality": "Helsinki",
                                            "postalCode": "530",
                                            "street": "Kanavaranta",
                                            "building": "7"
                                        },
                                        "contacts": {
                                            "phone": "+44 000 000 0000"
                                        }
                                    }
                                }
Example request: Parcel sent abroad via HANDS_EXPRESS. 
                                
                                    {
                                    "plan": {
                                        "code": "HANDS_EXPRESS"
                                    },
                                    "parcel": {
                                        "type": "H2F",
                                        "weight": "400",
                                        "dimensions": {
                                            "length": "28",
                                            "width": "29",
                                            "height": "30"
                                        },
                                        "content": {
                                            "items": [
                                                {
                                                    "summary": "Book",
                                                    "quantity": 1,
                                                    "amount": 50
                                                }
                                            ]
                                        }
                                    },
                                    "receiver": {
                                        "name": "Receiver FI",
                                        "address": {
                                            "countryCode": "FI",
                                            "locality": "Helsinki",
                                            "postalCode": "530",
                                            "street": "Kanavaranta",
                                            "building": "7"
                                        },
                                        "contacts": {
                                            "phone": "+44 000 000 0000"
                                        }
                                    }
                                }
Requirements Matrix
Parcel Requirements Matrix
Table X. Requirements Matrix

LT–LT (domestic):

Sender

Recipient

T2T

Parcel locker – Parcel locker

Mobile required
(for guests; for logged-in users mobile or landline)

Mobile required

T2H

Parcel locker – Recipient address

Mobile required
(for guests; for logged-in users mobile or landline)

Any phone required

H2T

Courier – Parcel locker

Any phone required

Mobile required

H2H

Courier – Recipient address

Any phone required

Any phone required

T2S

Storage

Mobile required
(for guests; for logged-in users mobile or landline)

Mobile required

P2H

Untracked

Any phone required

Not required

P2H

Signature required

Any phone required

Not required

LT Export:

Sender

Recipient

P2H

Tracked

Any phone required

Any phone required

P2H

Untracked

Any phone required

Not required

P2H

Signature required

Any phone required

Not required

H2H

Courier – Recipient address

Any phone required

Any phone required

2.3.2. get

GET /api/v2/parcel/{parcelId}

Get parcel

Description

To get details of a single parcel.

Parameters
Path Parameters
Name Description Required Default Pattern

parcelId

Unique identifier of the shipping item on “Mano siuntos” system.

X

null
Return Type

ParcelBaseResponse

Content Type

  • application/json

Responses
Table 2. HTTP Response Codes
Code Message Datatype

200

Shipping item data structure (see 3.10 ShippingItemType)

ParcelBaseResponse

400

Bad Request

ErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

2.3.3. getByIdRef

GET /api/v2/parcel/idref/{idRef}

Get parcel

Description

To get details of a single parcel.

Parameters
Path Parameters
Name Description Required Default Pattern

idRef

Unique identifier of the shipping item on “Mano siuntos” system.

X

null
Return Type

ParcelBaseResponse

Content Type

  • application/json

Responses
Table 3. HTTP Response Codes
Code Message Datatype

200

Shipping item data structure (see 3.10 ShippingItemType)

ParcelBaseResponse

400

Bad Request

ErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

2.3.4. update

It is possible to update, before initiate call, parcel (by id or idRef) information such as: address, plan, size, weight, services and etc.
Parcel update endpoint request has same structure as Parcel create, json fields will override current parcel data.

Services field will behave differently, as list it will not override it, but add new items. Example below

PUT /api/v2/parcel/{parcelId}

Update parcel

Description

To update and edit parcel details.

Parameters
Path Parameters
Name Description Required Default Pattern

parcelId

X

null
Body Parameter
Name Description Required Default Pattern

UpdateParcelRequest

UpdateParcelRequest

X
Return Type

[Object]

Content Type

  • application/json

Responses
Table 4. HTTP Response Codes
Code Message Datatype

200

OK

[Object]

400

Bad Request

FieldErrorResponse

404

Not Found

ErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

Samples

  1. Sample update request:

    curl --location --request PUT '<hostname>/api/v2/parcel/000000' \
                                            --header 'Content-Type: application/json' \
                                            --header 'Authorization: Bearer <authorization access token>' \
                                            --data-raw '{
                                                ...
                                                "services": [
                                                    {
                                                        "id": 2
                                                    }
                                                ]
                                            }'

  2. Get parcel by id response

    {
        ...
        "services": [
            {
                "id": 2,
                "code": "C_PIRM_LAISK",
                "included": false
            }
        ]
    }

  3. Sample second update request:

    curl --location --request PUT '<hostname>/api/v2/parcel/000000' \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Bearer <authorization access token>' \
    --data-raw '{
        ...
        "services": [
            {
                "id": 1
            }
        ]
    }'

  4. Get parcel by id response

    {
        ...
        "services": [
            {
                "id": 1,
                "code": "C_REG_LAISK&BIG",
                "included": false
            },
            {
                "id": 2,
                "code": "C_PIRM_LAISK",
                "included": false
            }
        ]
    }

  5. Note: also "services": [] will override existing data. But null will not:

    Request

    curl --location --request PUT '<hostname>/api/v2/parcel/000000' \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Bearer <authorization access token>' \
    --data-raw '{
        ...
        "services": null
    }'

    Response

    {
        ...
        "services": [
            {
                "id": 1,
                "code": "C_REG_LAISK&BIG",
                "included": false
            },
            {
                "id": 2,
                "code": "C_PIRM_LAISK",
                "included": false
            }
        ]
    }

    Request

    curl --location --request PUT '<hostname>/api/v2/parcel/000000' \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Bearer <authorization access token>' \
    --data-raw '{
        ...
        "services": []
    }'

    Response

    {
        ...
        "services": []
    }

2.3.5. updateByIdRef

PUT /api/v2/parcel/idref/{idRef}

Update parcel

Description

To update and edit parcel details.

Parameters
Path Parameters
Name Description Required Default Pattern

idRef

X

null
Body Parameter
Name Description Required Default Pattern

UpdateParcelRequest

UpdateParcelRequest

X
Return Type

[Object]

Content Type

  • application/json

Responses
Table 5. HTTP Response Codes
Code Message Datatype

200

OK

[Object]

400

Bad Request

FieldErrorResponse

404

Not Found

ErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

2.3.6. delete

DELETE /api/v2/parcel/{parcelId}

Delete parcel

Description

Delete single parcel.

Parameters
Path Parameters
Name Description Required Default Pattern

parcelId

Unique identifier of the parcel on “Mano siuntos” system.

X

null
Return Type

DeleteResponse

Content Type

  • application/json

Responses
Table 6. HTTP Response Codes
Code Message Datatype

200

If deleted will return true otherwise false

DeleteResponse

400

Bad Request

ErrorResponse

404

Not Found

ErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

2.3.7. deleteByIdRef

DELETE /api/v2/parcel/idref/{idRef}

Delete parcel

Description

Delete single parcel.

Parameters
Path Parameters
Name Description Required Default Pattern

idRef

Unique identifier of the parcel on “Mano siuntos” system.

X

null
Return Type

DeleteResponse

Content Type

  • application/json

Responses
Table 7. HTTP Response Codes
Code Message Datatype

200

If deleted will return true otherwise false

DeleteResponse

400

Bad Request

ErrorResponse

404

Not Found

ErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

2.4. ShippingOperations

2.4.1. isShippingAvailable

GET /api/v2/shipping/available

Check shipping availability

Description

Get shipping availability.

Parameters
Query Parameters
Name Description Required Default Pattern

receiverCountryCode

X

null

planCode

X

null

parcelType

X

null

size

-

null

weight

-

null

partCount

-

null

services

[String]

-

null

includeErrors

-

false
Return Type

ShippingAvailableResult

Content Type

  • application/json

Responses
Table 8. HTTP Response Codes
Code Message Datatype

200

Shipping available data structure

ShippingAvailableResult

400

Bad Request

ErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

2.4.2. initiateShipping

POST /api/v2/shipping/initiate

Initiate shipping

Description

To initiate dispatch of parcels. The response returns the identification numbers of shipping item carts. It is important to mention that when initiating shipments, they need to be grouped: UNISEND (LP EXPRESS) parcels and Lithuanian postal service parcels. But if you initiate at one time parcels with Lithuanian postal services and UNISEND (LP EXPRESS) services - then no statuses will appear after the initiation (there will be PENDING)

Parameters
Body Parameter
Name Description Required Default Pattern

BaseItemListRequest

BaseItemListRequest

X
Query Parameters
Name Description Required Default Pattern

processAsync

-

true
Return Type

InitiateShippingResponse

Content Type

  • application/json

Responses
Table 9. HTTP Response Codes
Code Message Datatype

200

Shipping initiation confirmed.

InitiateShippingResponse

400

Bad Request

FieldErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

2.4.3. getBarcodesByParcelIds

GET /api/v2/shipping/barcode/list

Get shipping barcodes

Description

Loads barcodes by a list of id refs, each item has OK or FAILED status and corresponding id

Parameters
Query Parameters
Name Description Required Default Pattern

parcelIds

A list of parcel ids to load barcodes. [Long]

X

null

idRefs

A list of id refs to load barcodes. [String]

X

null
Return Type

array[ShippingItemStatus]

Content Type

  • application/json

Responses
Table 10. HTTP Response Codes
Code Message Datatype

200

Load barcodes by idRefs.

List[ShippingItemStatus]

400

Bad Request

ErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

2.4.4. getStatusByRequestId

GET /api/v2/shipping/status/{requestId}

Get shipping status

Description

Get shipping status by request id. IN_PROGRESS - shipping process is still in progress, SUCCESSFUL - shipping completed successfully, PARTIALLY_SUCCESSFUL - shipping failed for at least one parcel, ERROR - shipping failed.

Parameters
Path Parameters
Name Description Required Default Pattern

requestId

X

null
Return Type

ShippingStatus

Content Type

  • application/json

Responses
Table 11. HTTP Response Codes
Code Message Datatype

200

Shipping status data structure

ShippingStatus

400

Bad Request

ErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

2.4.5. cancel

POST /api/v2/shipping/cancel

Cancel shipping

Description

To cancel shipping items.

Parameters
Body Parameter
Name Description Required Default Pattern

BaseItemListRequest

BaseItemListRequest

X
Return Type

[Object]

Content Type

  • application/json

Responses
Table 12. HTTP Response Codes
Code Message Datatype

200

Shipping cancel confirmed.

[Object]

400

Bad Request

FieldErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

2.4.6. return

POST /api/v2/shipping/return

Description

A return labels can be generated for previously created shipments.

You can submit one or multiple original shipment barcodes in a single request. For each provided barcode, the system will return a corresponding return barcode

Parameters
Body Parameter
Field Name Required Type Description Format

barcodes

Set of [string]
Return Type

[Object]

Content Type

  • application/json

Responses
Table 13. HTTP Response Codes
Code Message Datatype

200

Shipping return confirmed.

[Object]

400

Bad Request

FieldErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

2.5. StickerOperations

2.5.1. getPdfByParcelIds

GET /api/v2/sticker/pdf

Get stickers PDF

Description

To get stickers for initiated shipping items.

Parameters
Query Parameters
Name Description Required Default Pattern

parcelIds

Unique identifier of a shipping item. [Long]

X

null

layout

The format of shipping item sticker layout across the page.

X

null

labelOrientation

PORTRAIT or LANDSCAPE orientation may be applied for the sticker

-

null

includeCn23

Include CN23 forms into response

-

true

includeManifest

Include manifest into response

-

false

idRefs

Unique identifier of a shipping item. [String]

X

null
Return Type

[Object]

Content Type

  • application/pdf

  • application/json

Responses
Table 13. HTTP Response Codes
Code Message Datatype

200

OK

[Object]

400

Bad Request

ErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse
Samples
PDF | LAYOUT_10x15 | LANDSCAPE 
                                            
                                            curl --location --request GET 'GET /api/v2/sticker/pdf?parcelIds={{parcelId}}&layout=LAYOUT_10x15&labelOrientation=LANDSCAPE'
PDF | LAYOUT_10x15 | PORTRAIT 
                                            
                                            curl --location --request GET 'GET /api/v2/sticker/pdf?parcelIds={{parcelId}}&layout=LAYOUT_10x15&labelOrientation=PORTRAIT&includeCn23=false&includeManifest=false'
PDF | LAYOUT_10x15 | PORTRAIT | includeCn23 
                                            
                                            curl --location --request GET 'GET /api/v2/sticker/pdf?parcelIds={{parcelId}}&layout=LAYOUT_10x15&labelOrientation=PORTRAIT&includeCn23=true&includeManifest=false'
PDF | LAYOUT_10x15 | PORTRAIT | includeManifest 
                                            
                                            curl --location --request GET 'GET /api/v2/sticker/pdf?parcelIds={{parcelId}}&layout=LAYOUT_10x15&labelOrientation=PORTRAIT&includeCn23=false&includeManifest=true'

2.5.2. getSPDStickersByParcelIds

GET /api/v2/sticker/spd/list

Get stickers SPD

Description

To get SPD stickers for initiated shipping items.

Parameters
Query Parameters
Name Description Required Default Pattern

parcelIds

Unique identifier of a shipping item. [Long]

X

null

idRefs

Unique identifier of a shipping item ID ref. [String]

X

null
Return Type

array[ShippingItemLabel Shipping item label entity which represent label item.]

Content Type

  • application/json

Responses
Table 14. HTTP Response Codes
Code Message Datatype

200

OK

List[ShippingItemLabel Shipping item label entity which represent label item.]

400

Bad Request

ErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse
Samples
SPD 
                                            
                                            curl --location --request GET 'GET /api/v2/sticker/spd/list?parcelIds={{parcelId}}'

2.5.3. getStickersByParcelIds

GET /api/v2/sticker/list

Get stickers

Description

To get stickers for initiated shipping items.

Parameters
Query Parameters
Name Description Required Default Pattern

parcelIds

Unique identifier of a shipping item. [Long]

X

null

layout

The format of shipping item sticker layout across the page.

X

null

labelOrientation

PORTRAIT or LANDSCAPE orientation may be applied for the sticker

-

null

idRefs

Unique identifier of a shipping item. [String]

X

null
Return Type

array[ShippingItemLabel Shipping item label entity which represent label item.]

Content Type

  • application/json

Responses
Table 15. HTTP Response Codes
Code Message Datatype

200

OK

List[ShippingItemLabel Shipping item label entity which represent label item.]

400

Bad Request

ErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse
Samples
LIST | LAYOUT_10x15 | LANDSCAPE 
                                            
                                            curl --location --request GET 'GET /api/v2/sticker/list?parcelIds={{parcelId}}&layout=LAYOUT_10x15&labelOrientation=LANDSCAPE'
LIST | LAYOUT_10x15 | PORTRAIT 
                                            
                                            curl --location --request GET 'GET /api/v2/sticker/list?parcelIds={{parcelId}}&layout=LAYOUT_10x15&labelOrientation=PORTRAIT'

3. Endpoints

3.1. AddressOperations

3.1.1. create

POST /api/v2/address/sender

Create sender address

Description

To create sender address.

Parameters
Body Parameter
Name Description Required Default Pattern

PersonBase

PersonBase

X
Query Parameters
Name Description Required Default Pattern

strict

If true strictly address validation will be applied (address structure and all fields must be filled correctly)

-

false
Return Type

PersonResponse

Content Type

  • application/json

Responses
Table 16. HTTP Response Codes
Code Message Datatype

200

Returns created address.

PersonResponse

400

Bad Request

FieldErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

3.1.2. deleteSenderAddressById

DELETE /api/v2/address/sender/{id}

Delete sender address

Description

To delete a sender address by ID.

Parameters
Path Parameters
Name Description Required Default Pattern

id

X

null
Return Type

[Object]

Content Type

  • application/json

Responses
Table 17. HTTP Response Codes
Code Message Datatype

200

OK

[Object]

400

Bad Request

ErrorResponse

404

Not Found

ErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

3.1.3. get

GET /api/v2/address/sender

Get default sender address

Description

To get a default sender address.

Parameters
Return Type

PersonResponse

Content Type

  • application/json

Responses
Table 18. HTTP Response Codes
Code Message Datatype

200

Returns the default users sender address value.

PersonResponse

400

Bad Request

ErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

3.1.4. getSenderAddressById

GET /api/v2/address/sender/{id}

Get sender address

Description

To get a sender address by ID.

Parameters
Path Parameters
Name Description Required Default Pattern

id

X

null
Return Type

PersonResponse

Content Type

  • application/json

Responses
Table 19. HTTP Response Codes
Code Message Datatype

200

Returns users sender address value.

PersonResponse

400

Bad Request

ErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

3.1.5. update

PUT /api/v2/address/sender

Update default sender address

Description

To update a default sender address.

Parameters
Body Parameter
Name Description Required Default Pattern

PersonBase

PersonBase

X
Query Parameters
Name Description Required Default Pattern

strict

If true strictly address validation will be applied (address structure and all fields must be filled correctly)

-

false
Return Type

[List]

Content Type

  • application/json

Responses
Table 20. HTTP Response Codes
Code Message Datatype

200

Returns array of warnings if any exists.

List[[string]]

400

Bad Request

FieldErrorResponse

404

Not Found

ErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

3.1.6. updateSenderAddress

PUT /api/v2/address/sender/{id}

Update sender address

Description

To update sender address by ID.

Parameters
Path Parameters
Name Description Required Default Pattern

id

X

null
Body Parameter
Name Description Required Default Pattern

PersonBase

PersonBase

X
Query Parameters
Name Description Required Default Pattern

If true strictly address validation will be applied (address structure and all fields must be filled correctly)

-

false
Return Type

array[FieldErrorResponse]

Content Type

  • application/json

Responses
Table 21. HTTP Response Codes
Code Message Datatype

200

Returns array of warnings if any exists.

List[FieldErrorResponse]

400

Bad Request

FieldErrorResponse

404

Not Found

ErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

3.1.7. validate

POST /api/v2/address/validate

Validate address

Description

Validate address.

Parameters
Body Parameter
Name Description Required Default Pattern

PersonBase

PersonBase

X
Query Parameters
Name Description Required Default Pattern

strict

If true strictly address validation will be applied (address structure and all fields must be filled correctly)

-

false
Return Type

[Object]

Content Type

  • application/json

Responses
Table 22. HTTP Response Codes
Code Message Datatype

200

OK

[Object]

400

Bad Request

FieldErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

3.2. CourierOperations

3.2.1. callCourier

POST /api/v2/courier/call

Call courier

Description

To call a courier for individual shipping items. Check callCourier endpoint if courier call is possible.

Please note that by default, the courier is called automatically after each time you create a shipment. If you prefer to use the callCourier method and invite the courier at a time convenient for you, please contact us via email at api-manosiuntos@post.lt to enable this option.
Parameters
Body Parameter
Name Description Required Default Pattern

BaseItemListRequest

BaseItemListRequest

X
Return Type

array[CallCourierResult]

Content Type

  • application/json

Responses
Table 23. HTTP Response Codes
Code Message Datatype

200

OK

List[CallCourierResult]

400

Bad Request

FieldErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse
Samples
curl --location --request POST '<hostname>/api/v2/call' \
                                                --header 'Content-Type: application/json' \
                                                --header 'Authorization: Bearer <authorization access token>' \
                                                --data-raw '{
                                                    "parcelIds": [
                                                      {{parcelId}}
                                                    ] 
                                                  }'

3.2.2. callCourierPendingList

POST /api/v2/courier/pending/call

Call pending courier

Description

Call courier for all pending parcels.

Parameters
Body Parameter
Name Description Required Default Pattern

body

[DateTime]

-
Return Type

array[CallCourierResult]

Content Type

  • application/json

Responses
Table 24. HTTP Response Codes
Code Message Datatype

200

OK

List[CallCourierResult]

400

Bad Request

FieldErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse
Samples
curl --location --request POST '/api/v2/pending/call?createdBeforeDate=2024-01-22T08:24:14.128Z&createdBefore&createdBeforeUnit'

3.2.3. callCourierRequired

GET /api/v2/courier/call/required

Call courier required

Description

Check is call courier required.

Parameters
Return Type

[Boolean]

Content Type

  • application/json

Responses
Table 25. HTTP Response Codes
Code Message Datatype

200

OK

[Boolean]

400

Bad Request

ErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse
Samples
curl --location --request GET '<hostname>/api/v2/courier/call/required' \
                                                --header 'Content-Type: application/json' \
                                                --header 'Authorization: Bearer <authorization access token>' \
                                                --data-raw '{
                                                    "parcelIds": [
                                                      {{parcelId}}
                                                    ] 
                                                  }'

3.2.4. getManifestByParcelId

GET /api/v2/courier/manifest/list

Get manifests

Description

To get a manifest/manifests for completed shipping item/items based on ID ref.

Parameters
Query Parameters
Name Description Required Default Pattern

parcelIds

Shipping item identifier. [Long]

X

null

idRefs

Shipping item identifier reference. [String]

X

null
Return Type

array[BaseDocumentResponse]

Content Type

  • application/json

Responses
Table 26. HTTP Response Codes
Code Message Datatype

200

Document of the shipping item courier manifest.

List[BaseDocumentResponse]

400

Bad Request

ErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

3.2.5. getManifestPdfByParcelId

GET /api/v2/courier/manifest/pdf

Get manifests PDF

Description

To get a manifest/manifests PDF for completed shipping item/items based on ID ref.

Parameters
Query Parameters
Name Description Required Default Pattern

parcelIds

Shipping item identifier. [Long]

X

null

idRefs

Shipping item identifier reference. [String]

X

null
Return Type

[Object]

Content Type

  • application/pdf

  • application/json

Responses
Table 27. HTTP Response Codes
Code Message Datatype

200

PDF document of the shipping item courier manifest.

[Object]

400

Bad Request

ErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

2.2.6. getPendingList

GET /api/v2/courier/pending/list

Get pending courier list

Description

To list shipping items for courier call. Check callCourier endpoint if courier call is possible.

Parameters
Query Parameters
Name Description Required Default Pattern

createdBefore

Date filter to filter data older then this date. Format yyyy-MM-ddTHH:mm:ss

X

null

page

-

0
Return Type

SliceResultImplCallCourierResult

Content Type

  • application/json

Responses
Table 28. HTTP Response Codes
Code Message Datatype

200

OK

SliceResultImplCallCourierResult

400

Bad Request

ErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

3.3. DocumentsOperations

3.3.1. getPdfByParcelIds

GET /api/v2/documents/cn/pdf

Get CN PDF

Description

To get CN labels for initiated shipping items.

Parameters
Query Parameters
Name Description Required Default Pattern

parcelIds

Unique identifier of a shipping item. [Long]

X

null

idRefs

Unique identifier of a shipping item. [String]

X

null
Return Type

[Object]

Content Type

  • application/pdf

  • application/json

Responses
Table 29. HTTP Response Codes
Code Message Datatype

200

OK

[Object]

400

Bad Request

ErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

3.4. EstimateShippingOperations

3.4.1. estimatePlan

GET /api/v2/shipping/estimate/plan

Estimate shipping plan

Description

Estimate shipping plan.

Parameters
Query Parameters
Name Description Required Default Pattern

receiverCountryCode

X

null

senderCountryCode

-

null

size

-

null

weight

-

null

planCode

-

null

parcelType

-

null

includeCountries

-

false

includeTerminals

-

false
Return Type

array[EstimatedPlan]

Content Type

  • application/json

Responses
Table 30. HTTP Response Codes
Code Message Datatype

200

Estimated Shipping plan data structure

List[EstimatedPlan]

400

Bad Request

ErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

3.4.2. estimatePlanCountries

GET /api/v2/shipping/estimate/plan/{planCode}/countries

Estimate shipping plan countries

Description

Estimate shipping plan countries.

Parameters
Path Parameters
Name Description Required Default Pattern

planCode

X

null
Query Parameters
Name Description Required Default Pattern

senderCountryCode

-

null

size

-

null

weight

-

null

parcelType

X

null
Return Type

array[EstimatedCountry]

Content Type

  • application/json

Responses
Table 31. HTTP Response Codes
Code Message Datatype

200

Estimated Shipping plan country data list structure

List[EstimatedCountry]

400

Bad Request

ErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

3.4.3. estimatePrice

GET /api/v2/shipping/estimate/price

Estimate shipping price

Description

Estimate shipping price.

Parameters
Query Parameters
Name Description Required Default Pattern

receiverCountryCode

X

null

senderCountryCode

X

null

planCode

X

null

parcelType

X

null

senderPostalCode

-

null

size

-

null

weight

-

null

partCount

-

null

services

[String]

-

null

3.4.4. estimateDutyPrice

POST /api/v2/duty/estimate/price

Description

Retrieve only customs duty and administration fee amounts:

Example: Request for only Customs Duty and Administration Fees 
                                POST: /api/v2/duty/estimate/price
                                
                                [
                                {
                                    "id": "UniqueId",
                                    "country": "US",
                                    "currencyCode": "USD",
                                    "pieces": [
                                    {
                                        "title": "books",
                                        "hsCode": "47073010",
                                        "countryCode": "EE",
                                        "quantity": 1,
                                        "price": {
                                        "amount": 50000,
                                        "currency": "EUR"
                                        },
                                        "contentType": "SELL"
                                    },
                                {
                                        "title": "candies",
                                        "hsCode": "5870730101",
                                        "countryCode": "EE",
                                        "quantity": 1,
                                        "price": {
                                        "amount": 15,
                                        "currency": "EUR"
                                        },
                                        "contentType": "SELL"
                                    }
                                    ]
                                }
                                ]
Example: Response with only customs duty and administration fees 
                                
                                [
                                {
                                    "id": "UniqueId",
                                    "dutyServices": [
                                    {
                                        "amount": 150,
                                        "fee": 2,
                                        "currency": "EUR"
                                    },
                                    {
                                        "amount": 150,
                                        "fee": 2,
                                        "currency": "USD"
                                    }
                                    ]
                                }
                                ]
Parameters
Query Parameters
Name Description Required

id

Unique shipment identifier

X

country

Receiver country

X

currencyCode

Currency of the shipment

X

pieces

Array of shipment items

X

pieces[].title

Item title/description

X

pieces[].hsCode

HS code (6, 8 or 10 digits)

X

pieces[].countryCode

Country of origin

X

pieces[].quantity

Quantity of items

X

pieces[].price.amount

Item price (minor units, e.g. cents)

X

pieces[].price.currency

Currency of the price

X

pieces[].contentType

Purpose of the shipment (e.g. SAMPLE, OTHER, GIFT, RETURN, SELL, DOCUMENT)

X

To get the full shipping cost including customs duty and administration fees:
In the EstimateShippingOperations endpoints (POST methods), add the documents object (same structure as used in shipment creation).

It is mandatory to provide:
  • hsCode (6, 8, or 10 digits)
  • countryCode (country of origin)

These fields are required in order to calculate the exact total price.

Example: Request to get the full shipping cost including customs duty and administration fees 
                                POST: /api/v2/shipping/estimate/price/list
                                
                                {
                                "senderAddressId": 0,
                                "items": [
                                    {
                                        "id": "123",
                                        "receiverCountryCode": "US",
                                        "receiverPostalCode": "14331",
                                        "size": "S",
                                        "weight": 10,
                                        "partCount": 1,
                                        "planCode": "TRACKED",
                                        "parcelType": "P2H",
                                        "documents": {
                                            "cn": {
                                                "contentType": "GIFT",
                                                "parts": [
                                                    {
                                                        "summary": "Knyga",
                                                        "weight": 5,
                                                        "quantity": 1,
                                                        "hsCode": 123456,
                                                        "amount": 999,
                                                        "currencyCode": "EUR",
                                                        "countryCode": "LT"
                                                    }
                                                ]
                                            }
                                        },
                                        "services": [
                                            {
                                                "code": "null",
                                                "value": "null"
                                            }
                                        ]
                                    }
                                ]
                            }
Example: Response with the full shipping cost, including customs duty and administration fees 
                                
                                [
                                {
                                    "id": "123",
                                    "price": {
                                        "amount": 8.45,
                                        "currency": "EUR"
                                    }
                                }
                                ]
For shipments to the USA, the following requirements apply:
  1. Additional contract agreement.
  2. User consent to pay customs duty and administration fees.
  3. In Self-Service, API v2 users must edit their profile and check “I agree to pay customs duty and commission fee” (one-time action).
  4. If consent is given → user can create shipments to the USA via API v2 and self-service.
  5. If not → shipments to the USA are blocked, except for “documents only”, which can be created without customs declaration.

Users can check duty fee amounts using the new duty/estimate/price and existing shipping/estimate/price endpoints.

3.5. PODReportOperations

3.5.1. getPodReportByParcelId11

GET /api/v2/pod/report

Get POD PDF by date range

Description

Get POD by date date range.

Parameters
Query Parameters
Name Description Required Default Pattern

parcelId

X

null

idRef

X

null

dateFrom

X

null

dateTo

X

null
Return Type

[Object]

Content Type

  • application/pdf

  • application/json

Responses
Table 33. HTTP Response Codes
Code Message Datatype

200

POD found successfully

[Object]

404

POD not found for specified time frame

[Object]

400

Bad Request

ErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

2.6. ParcelOperations

2.6.1. create

POST /api/v2/parcel

Create parcel

Description

Creates single parcel item.

Parameters
Body Parameter
Name Description Required Default Pattern

CreateParcelRequest

CreateParcelRequest

X
Return Type

ParcelCreateResponse

Content Type

  • application/json

Responses
Table 34. HTTP Response Codes
Code Message Datatype

200

Parcel ID and list of warnings if any exists

ParcelCreateResponse

400

Bad Request

FieldErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

2.6.2. delete

DELETE /api/v2/parcel/{parcelId}

Delete parcel

Description

Delete single parcel.

Parameters
Path Parameters
Name Description Required Default Pattern

parcelId

Unique identifier of the parcel on “Mano siuntos” system.

X

null
Return Type

DeleteResponse

Content Type

  • application/json

Responses
Table 35. HTTP Response Codes
Code Message Datatype

200

If deleted will return true otherwise false

DeleteResponse

400

Bad Request

ErrorResponse

404

Not Found

ErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

2.6.3. deleteByIdRef

DELETE /api/v2/parcel/idref/{idRef}

Delete parcel

Description

Delete single parcel.

Parameters
Path Parameters
Name Description Required Default Pattern

idRef

Unique identifier of the parcel on “Mano siuntos” system.

X

null
Return Type

DeleteResponse

Content Type

  • application/json

Responses
Table 36. HTTP Response Codes
Code Message Datatype

200

If deleted will return true otherwise false

DeleteResponse

400

Bad Request

ErrorResponse

404

Not Found

ErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

2.6.4. get

GET /api/v2/parcel/{parcelId}

Get parcel

Description

To get details of a single parcel.

Parameters
Path Parameters
Name Description Required Default Pattern

parcelId

Unique identifier of the shipping item on “Mano siuntos” system.

X

null
Return Type

ParcelBaseResponse

Content Type

  • application/json

Responses
Table 37. HTTP Response Codes
Code Message Datatype

200

Shipping item data structure (see 3.10 ShippingItemType)

ParcelBaseResponse

400

Bad Request

ErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

2.6.5. getByIdRef

GET /api/v2/parcel/idref/{idRef}

Get parcel

Description

To get details of a single parcel.

Parameters
Path Parameters
Name Description Required Default Pattern

idRef

Unique identifier of the shipping item on “Mano siuntos” system.

X

null
Return Type

ParcelBaseResponse

Content Type

  • application/json

Responses
Table 38. HTTP Response Codes
Code Message Datatype

200

Shipping item data structure (see 3.10 ShippingItemType)

ParcelBaseResponse

400

Bad Request

ErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

2.6.6. update

PUT /api/v2/parcel/{parcelId}

Update parcel

Description

To update and edit parcel details.

Parameters
Path Parameters
Name Description Required Default Pattern

parcelId

X

null
Body Parameter
Name Description Required Default Pattern

UpdateParcelRequest

UpdateParcelRequest

X
Return Type

[Object]

Content Type

  • application/json

Responses
Table 39. HTTP Response Codes
Code Message Datatype

200

OK

[Object]

400

Bad Request

FieldErrorResponse

404

Not Found

ErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

2.6.7. updateByIdRef

PUT /api/v2/parcel/idref/{idRef}

Update parcel

Description

To update and edit parcel details.

Parameters
Path Parameters
Name Description Required Default Pattern

idRef

X

null
Body Parameter
Name Description Required Default Pattern

UpdateParcelRequest

UpdateParcelRequest

X
Return Type

[Object]

Content Type

  • application/json

Responses
Table 40. HTTP Response Codes
Code Message Datatype

200

OK

[Object]

400

Bad Request

FieldErrorResponse

404

Not Found

ErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

2.7. ShippingOperations

2.7.1. cancel

POST /api/v2/shipping/cancel

Cancel shipping

Description

To cancel shipping items.

Parameters
Body Parameter
Name Description Required Default Pattern

BaseItemListRequest

BaseItemListRequest

X
Return Type

[Object]

Content Type

  • application/json

Responses
Table 41. HTTP Response Codes
Code Message Datatype

200

Shipping cancel confirmed.

[Object]

400

Bad Request

FieldErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

2.7.2. getBarcodesByParcelIds1

GET /api/v2/shipping/barcode/list

Get shipping barcodes

Description

Loads barcodes by a list of id refs, each item has OK or FAILED status and corresponding id

Parameters
Query Parameters
Name Description Required Default Pattern

parcelIds

A list of parcel ids to load barcodes. [Long]

X

null

idRefs

A list of id refs to load barcodes. [String]

X

null
Return Type

array[ShippingItemStatus]

Content Type

  • application/json

Responses
Table 42. HTTP Response Codes
Code Message Datatype

200

Load barcodes by idRefs.

List[ShippingItemStatus]

400

Bad Request

ErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

2.7.3. getStatusByRequestId

GET /api/v2/shipping/status/{requestId}

Get shipping status

Description

Get shipping status by request id. IN_PROGRESS - shipping process is still in progress, SUCCESSFUL - shipping completed successfully, PARTIALLY_SUCCESSFUL - shipping failed for at least one parcel, ERROR - shipping failed.

Parameters
Path Parameters
Name Description Required Default Pattern

requestId

X

null
Return Type

ShippingStatus

Content Type

  • application/json

Responses
Table 43. HTTP Response Codes
Code Message Datatype

200

Shipping status data structure

ShippingStatus

400

Bad Request

ErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

2.7.4. initiateShipping

POST /api/v2/shipping/initiate

Initiate shipping

Description

To initiate dispatch of parcels. The response returns the identification numbers of shipping item carts. It is important to mention that when initiating shipments, they need to be grouped: UNISEND parcels and Lithuanian postal service parcels. But if you initiate at one time parcels with Lithuanian postal services and UNISEND services - then no statuses will appear after the initiation (there will be PENDING)

Parameters
Body Parameter
Name Description Required Default Pattern

BaseItemListRequest

BaseItemListRequest

X
Query Parameters
Name Description Required Default Pattern

processAsync

-

true
Return Type

InitiateShippingResponse

Content Type

  • application/json

Responses
Table 44. HTTP Response Codes
Code Message Datatype

200

Shipping initiation confirmed.

InitiateShippingResponse

400

Bad Request

FieldErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

2.7.5. isShippingAvailable

GET /api/v2/shipping/available

Check shipping availability

Description

Get shipping availability.

Parameters
Query Parameters
Name Description Required Default Pattern

receiverCountryCode

X

null

planCode

X

null

parcelType

X

null

size

-

null

weight

-

null

partCount

-

null

services

[String]

-

null

includeErrors

-

false
Return Type

ShippingAvailableResult

Content Type

  • application/json

Responses
Table 45. HTTP Response Codes
Code Message Datatype

200

Shipping available data structure

ShippingAvailableResult

400

Bad Request

ErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

3.6. TerminalOperations

3.6.1. estimate

GET /api/v2/terminal

Get terminals

Description

Terminals.

Parameters
Query Parameters
Name Description Required Default Pattern

receiverCountryCode

X

null

senderCountryCode

-

null

size

-

null
Return Type

array[EstimatedTerminal]

Content Type

  • application/json

Responses
Table 46. HTTP Response Codes
Code Message Datatype

200

Terminal list structure

List[EstimatedTerminal]

400

Bad Request

ErrorResponse

403

Forbidden

<<>>

401

Unauthorized

<<>>

500

Internal Server Error

ErrorResponse

3. Models

3.1. AddressBase

Field Name Required Type Description Format

municipality

String

locality

String

flat

String

building

String

address

String

address1

String

address2

String

terminalId

String

district

String

street

String

postalCode

String

countryCode

String

subDistrict

String

countryId

Long

int64

regionId

Long

int64

3.2.1. Phone Number Requirements

Types planCodes receiver phone number sender phone number

P2H

UNTRACKED

LT ➜ LT - Not required.
LT ➜ Abroad - Phone number or email required.

Required.

TRACKED

Phone number or email required.

Required.

SIGNED

LT ➜ LT - Not required.
LT ➜ Abroad - Phone number or email required.

Required.

H2H

HANDS

Required.

Required.

T2H

T2T

TERMINAL

Required.

Required.

H2T

T2S

H2P

TRACKED_SIGNED

Required.

Required.

H2F

HANDS_EXPRESS

Required.

Required.

3.2.2 Phone Number Validation

Parcel Type

Address Type

Allowed Formats

Additional rules

Courier
(T2H, H2H, H2P)

Sender & Receiver

+37000000000, +37100000000, +37200000000
+37060000000, +37120000000, +37250000000, +37280000000
0037000000000, 0037100000000, 0037200000000
0037060000000, 0037120000000, 0037250000000, 0037280000000
+37020000000, 052000000, 0037020000000, 60000000

Starts with 8 → replace with +370
Starts with 0 → replace with +370

Terminal
(T2S, T2T, H2T)

Sender

+37000000000, +37100000000, +37200000000
+37060000000, +37120000000, +37250000000, +37280000000
0037000000000, 0037100000000, 0037200000000
0037060000000, 0037120000000, 0037250000000, 0037280000000
+37020000000, 052000000, 0037020000000, 60000000

Starts with 8 → replace with +370
Starts with 0 → replace with +370

Receiver

Only mobile numbers:
+37060000000, +37120000000, +37250000000, +3725000000 +37280000000, +3728000000
0037060000000, 0037120000000, 0037250000000, 003725000000, 0037280000000, 003728000000

Starts with 8 → replace with +370
Starts with 0 → replace with +370

Post Office
(P2H)

Sender & Receiver

+37000000000, +37100000000, +37200000000
+37060000000, +37120000000, +37250000000, +37280000000
0037000000000, 0037100000000, 0037200000000
0037060000000, 0037120000000, 0037250000000, 0037280000000
+37020000000, 052000000, 0037020000000, 60000000

Starts with 8 → replace with +370
Starts with 0 → replace with +370

3.3. BaseItemListRequest

Unique identifier of the shipping item.

Field Name Required Type Description Format

idRefs

Set of [string]

parcelIds

Set of [long]

int64

3.4. BasicService

Field Name Required Type Description

code

 X

String

value

 X

String

3.4.1. Service Codes

Auto-IncludedOptional – Request via API
  • POD - Proof Of Delivery (Auto-Included in HANDS_EXPRESS plan only)
  • PRIORITY - Priority shipping
  • RETURN_ON_FAILURE - Return in case of not picking up
  • SIGNED - Delivery by signature
  • STORAGE_10 - Storage at the post office for 10 days
  • SIGNED_BY_RECEIVER - Recipient of the shipment signs after successfully receiving the package
  • STORAGE_7 - Storage at the post office for 7 days
  • REPEAT_DELIVERY – Redelivery
  • SIGNED_BY_RECEIVER - Recipient of the shipment signs after successfully receiving the package
  • INSURANCE - Insurance (Not Auto-Included in HANDS_EXPRESS plan)
  • POD - Proof Of Delivery
  • COD - Cash On Delivery
  • DELIVERY_ON_TIME - Deliver at your chosen time
  • SAME_DAY_DELIVERY - Deliver the parcel on the same day
  • PAYEE_PAYS - Receiver pays shipping
  • STICKER - Sticker delivery (Not available for the HANDS_EXPRESS plan)
  • COVER_LETTER - Send a shipment with a cover letter
  • LOAD_ASSISTANCE - Loading works are required
  • SATURDAY_DELIVERY - Delivery on Saturday
  • INSURANCE - Insurance (HANDS_EXPRESS (Max 5 000,00 €), TRACKED plan only)
  • PRODUCT_RETURN - Create an additional return label

Example request: COD service Request Body 
                                
                                {
                                "plan": {
                                    "code": "TERMINAL"
                                },
                                "parcel": {
                                    "type":"T2T",
                                    "size": "XS"
                                },
                                "services": [{
                                    "code": "COD",
                                    "value": "9.99"
                                }],
                                "receiver": {
                                    "name": "test name",
                                        "address" : {
                                            "countryCode": "LT",
                                            "terminalId": "0101"
                                        },
                                    "contacts":{
                                        "phone":"+37060000000"
                                    }
                                }
                                }
Example request: PRODUCT_RETURN service Request Body 
                                
                                {
                                "plan": {
                                    "code": "TERMINAL"
                                },
                                "parcel": {
                                    "type":"H2T",
                                    "size": "XS"
                                },
                                "services": [{
                                    "code": "PRODUCT_RETURN"
                                }],
                                "receiver": {
                                    "name": "test name",
                                        "address" : {
                                            "countryCode": "LT",
                                            "terminalId": "0101"
                                        },
                                    "contacts":{
                                        "phone":"+37060000000"
                                    }
                                }
                                }

3.5. CallCourierResult

Field Name Required Type Description Format

barcode

String

parcelId

Long

int64

idRef

String

created

Date

date-time

3.6. CnBaseCnPartBase

Field Name Required Type Description Format

contentType

String

contentDescription

String

failureInstruction

String

importer

CnImporterBase

exporter

CnExporterBase

documents

CnDocumentBase

parts

List of CnPartBase

3.7. CnDocumentBase

Field Name Required Type Description Format

license

String

certificate

String

invoice

String

notes

String

3.8. CnExporterBase

Field Name Required Type Description Format

customsRegistrationNo

String

3.9. CnImporterBase

Field Name Required Type Description Format

taxCode

String

vatCode

String

code

String

contact

ContactBase

customsRegistrationNo

String

3.10. CnPartBase

Field Name Required Type Description Format

summary

X

String

weight

X

Integer

int32

quantity

X

Integer

int32

hsCode

Integer

int32

amount

X

BigDecimal

currencyCode

X

String

countryCode

String

3.11. CnPartRequest

Field Name Required Type Description Format

summary

X

String

weight

X

Integer

int32

quantity

X

Integer

int32

hsCode

Integer

int32

amount

X

BigDecimal

currencyCode

X

String

countryCode

String

3.12. CnRequest

Field Name Required Type Description Format

contentType

String

contentDescription

String

failureInstruction

String

importer

CnImporterBase

exporter

CnExporterBase

documents

CnDocumentBase

parts

List of CnPartRequest

3.13. ContactBase

Field Name Required Type Description Format

phone

String

email

String

fax

String

3.14. ContactRequest

Field Name Required Type Description Format

phone

String

email

String

fax

String

3.15. CreateParcelRequest

Field Name Required Type Description Format

source

String

idRef

String

senderAddressId

Long

int64

pickupAddressId

Long

int64

comment

String

plan

X

PlanRequest

parcel

X

ParcelRequest

receiver

X

PersonRequest

sender

PersonRequest

pickup

PersonRequest

documents

DocumentRequest

services

List of BasicService

3.16. DeleteResponse

Field Name Required Type Description Format

deleted

Boolean

3.17. DocumentRequest

Field Name Required Type Description Format

cn

CnRequest

3.18. DocumentResponse

Field Name Required Type Description Format

cn

CnBaseCnPartBase

3.19. ErrorResponse

Field Name Required Type Description Format

error

String

error_description

String

3.20. EstimatedCountry

Field Name Required Type Description Format

name

String

code

String

3.21. EstimatedParcelSize

Field Name Required Type Description Format

code

String

length

Float

float

width

Float

float

height

Float

float

unit

String

3.22. EstimatedPlan

Field Name Required Type Description Format

code

String

description

String

shipping

List of EstimatedPlanShipping

3.23. EstimatedPlanShipping

Field Name Required Type Description Format

parcelType

String

options

List of EstimatedShippingOption

requirements

EstimatedRequirements

3.24. EstimatedRangeInteger

Field Name Required Type Description Format

min

Integer

int32

max

Integer

int32

unit

String

3.25. EstimatedRequirements

Field Name Required Type Description Format

size

Boolean

weight

Boolean

cnDocument

Boolean

3.26. EstimatedService

Field Name Required Type Description Format

id

Long

int64

code

String

description

String

price

EstimatedShippingPrice

included

Boolean

value

String

options

List of EstimatedServiceOption

3.27. EstimatedServiceOption

Field Name Required Type Description Format

id

String

value

String

price

EstimatedShippingPrice

3.28. EstimatedShippingOption

Field Name Required Type Description Format

price

EstimatedShippingPrice

size

EstimatedParcelSize

weight

Integer

int32

weightRange

EstimatedRangeInteger

partCountRange

EstimatedRangeInteger

services

List of EstimatedService

countries

Set of EstimatedCountry

terminals

List of EstimatedTerminal

3.29. EstimatedShippingPrice

Field Name Required Type Description Format

amount

BigDecimal

currency

String

3.30. EstimatedTerminal

Field Name Required Type Description Format

id

String

countryCode

String

3.31. FieldErrorResponse

Field Name Required Type Description Format

field

String

error

String

error_description

String

3.32. InitiateShippingResponse

Field Name Required Type Description Format

requestId

String

3.33. ParcelBase

Field Name Required Type Description Format

type

String

size

String

weight

Integer

int32

partCount

Integer

int32

document

Boolean

3.34. ParcelBaseResponse

Field Name Required Type Description Format

id

Long

int64

idRef

String

plan

PlanBase

parcel

ParcelBase

receiver

PersonBase

sender

PersonBase

pickup

PersonBase

documents

DocumentResponse

services

List of ServiceBase

price

Price

3.35. ParcelCreateResponse

Field Name Required Type Description Format

parcelId

Long

int64

warnings

List of FieldErrorResponse

3.36. ParcelRequest

Field Name Required Type Description Format

type

String

size

String

weight

Integer

int32

partCount

Integer

int32

document

Boolean

3.37. PersonBase

Field Name Required Type Description Format

name

String

companyName

String

contacts

ContactBase

address

X

AddressBase

3.38. PersonRequest

Field Name Required Type Description Format

name

String

companyName

String

contacts

ContactRequest

address

X

AddressBase

3.39. PersonResponse

Field Name Required Type Description Format

name

String

companyName

String

contacts

ContactBase

address

X

AddressBase

id

Long

int64

3.40. PlanBase

Field Name Required Type Description Format

code

X

String

3.41. PlanRequest

Field Name Required Type Description Format

code

X

String

3.42. Price Price entity.

Field Name Required Type Description Format

amount

BigDecimal

vat

BigDecimal

currency

String

3.43. ServiceBase

Field Name Required Type Description Format

id

X

Long

int64

code

String

value

String

3.44. ShippingAvailableResult

Field Name Required Type Description Format

available

Boolean

errors

List of TranslatedValidationError

3.45. ShippingItemLabel Shipping item label entity which represent label item.

Field Name Required Type Description Format

itemId

String

label

List of [ByteArray]

byte

contentType

String

Enum: application/pdf,

3.46. ShippingItemStatus

Field Name Required Type Description Format

barcode

String

parcelId

Long

int64

idRef

String

status

String

trackable

Boolean

3.47. ShippingStatus

Field Name Required Type Description Format

status

String

Enum: IN_PROGRESS, CREATED, WAITING_FOR_PAYMENT, SUCCESSFUL, PARTIALLY_SUCCESSFUL, ERROR,

errors

Set of [string]

items

List of ShippingItemStatus

3.48. SliceResultImplCallCourierResult

Field Name Required Type Description Format

content

List of CallCourierResult

hasNext

Boolean

hasPrevious

Boolean

3.49. TranslatedValidationError

Field Name Required Type Description Format

id

Object

error

String

error_description

String

3.50. UpdateParcelRequest

Field Name Required Type Description Format

idRef

String

parcelId

Long

int64

senderAddressId

Long

int64

pickupAddressId

Long

int64

comment

String

plan

X

PlanRequest

parcel

X

ParcelRequest

receiver

PersonRequest

sender

PersonRequest

pickup

PersonRequest

documents

DocumentRequest

services

List of BasicService

4. Address search

Possibility to search address by query parameters. Address search available only for LT addresses.

4.1. Overview

Address API public documentation.
To understand what addresses look like, we have 3 types of addresses:
With streets and buildings, e.g., Dariaus ir Girėno g. 7, 74119 Jurbarkas
Without streets and buildings, e.g., Ūta, Rumšiškių sen., Kaišiadorių r. sav. 56370
With buildings without streets, e.g., 1, 88316 Kairiai (Telšių r. sav.)

4.2. Paths

4.1. Gathers information about municipalities.

GET /api/v2/address/lt/munics

Parameters

Type Name Description Schema Default

Query

q
optional

Municipality name

string

Query

skip
optional

Amount of municipalities to skip

integer (int32)

Query

take
optional

Amount of municipalities to return

integer (int32)

20

Responses

HTTP Code Description Schema

200

Success

Address.Library.AddressSearchResult<Munic>

500

Internal server error

No Content

Produces

  • application/json

Tags

  • Address

Example HTTP response

Response 200
{
                  "data" : [ {
                    "data" : {
                      "id" : 103,
                      "name" : "Vilniaus m. sav."
                    },
                    "type" : "munics"
                  } ],
                  "skip" : 0,
                  "take" : 20,
                  "total" : 1
                }

4.2. Gathers information about post codes.

GET /api/v2/address/lt/postcodes

Parameters

Type Name Description Schema Default

Query

q
optional

Post code

string

Query

skip
optional

Amount of post codes to skip

integer (int32)

Query

take
optional

Amount of post codes to return

integer (int32)

20

Responses

HTTP Code Description Schema

200

Success

Address.Library.AddressSearchResult<PostCode>

500

Internal server error

No Content

Produces

  • application/json

Tags

  • Address

Example HTTP response

Response 200
{
                  "data" : [ {
                    "data" : {
                      "deliveryZoneId" : 1,
                      "firstLocalityId" : 44,
                      "id" : 109303,
                      "name" : "08247",
                      "postId" : 1885,
                      "postName" : "Vilniaus 57-asis paštas",
                      "postPostCode" : "08013",
                      "type" : "Address"
                    },
                    "type" : "postcodes"
                  } ],
                  "skip" : 0,
                  "take" : 20,
                  "total" : 1
                }

4.3. Gathers addresses by specified post code.

GET /api/v2/address/lt/postcodes/{postcodeId}/addresses

Parameters

Type Name Description Schema Default

Path

postcodeId
required

Post code Id

integer (int32)

Query

q
optional

Address

string

Query

skip
optional

Amount of addresses to skip

integer (int32)

Query

take
optional

Amount of addresses to return

integer (int32)

20

Responses

HTTP Code Description Schema

200

Success

Address.Library.AddressSearchResult<AddressInfo>

500

Internal server error

No Content

Produces

  • application/json

Tags

  • Address

Example HTTP response

Response 200
{
                  "data" : [ {
                    "data" : {
                      "address" : "Juozo Balčikonio g. 3, Vilnius, Vilniaus m. sav. 08247",
                      "addressCount" : 137,
                      "buildId" : 1077394,
                      "buildingNr" : "3",
                      "deliveryAreaId" : 23691,
                      "deliveryAreaName" : "13",
                      "deliveryPostOfficeId" : 16516,
                      "deliveryPostOfficeName" : "Vilniaus Jeruzalės siuntų centras",
                      "deliveryZoneId" : 1,
                      "districtId" : 10,
                      "districtName" : "Vilniaus",
                      "geoLocation" : {
                        "lat" : 54.719491,
                        "lon" : 25.28543
                      },
                      "guid" : "455f220b-082e-4816-9d68-ba9998763cc1",
                      "id" : 1077394,
                      "localityId" : 44,
                      "localityName" : "Vilnius",
                      "municipalityId" : 103,
                      "municipalityName" : "Vilniaus m. sav.",
                      "orderId" : 362504,
                      "postCode" : "08247",
                      "postCodeId" : 109303,
                      "postId" : 1885,
                      "postName" : "Vilniaus 57-asis paštas",
                      "postOfficeCode" : "08013",
                      "streetId" : 31097,
                      "streetName" : "Juozo Balčikonio g."
                    },
                    "type" : "addresses"
                  } ],
                  "skip" : 0,
                  "take" : 20,
                  "total" : 1
                }

4.4. Gathers information about post offices.

GET /api/v2/address/lt/postoffices

Parameters

Type Name Description Schema Default

Query

q
optional

Post office name or address

string

Query

skip
optional

Amount of postoffices to skip

integer (int32)

Query

take
optional

Amount of postoffices to return

integer (int32)

20

Responses

HTTP Code Description Schema

200

Success

Address.Library.AddressSearchResult<PostOffice>

500

Internal server error

No Content

Produces

  • application/json

Tags

  • Address

Example HTTP response

Response 200
{
                  "data" : [ {
                    "data" : {
                      "countyId" : 10,
                      "countyName" : "Vilniaus",
                      "districtId" : 10,
                      "districtName" : "Vilniaus",
                      "flags" : [ ],
                      "id" : 16516,
                      "localityId" : 44,
                      "localityName" : "Vilniaus",
                      "localityNameV" : "Vilnius",
                      "localityType" : "City",
                      "municipalityId" : 103,
                      "municipalityName" : "Vilniaus m. sav.",
                      "name" : "Vilniaus Jeruzalės siuntų centras",
                      "postAddress" : "Jeruzalės g. 14, Vilnius",
                      "postBuildId" : 674304,
                      "postCode" : "12020",
                      "retailType" : 7,
                      "type" : "StandardPost"
                    },
                    "type" : "postoffices"
                  } ],
                  "skip" : 0,
                  "take" : 20,
                  "total" : 1
                }

4.5. Gathers information about localities.

GET /api/v2/address/lt/reallocalities

Parameters

Type Name Description Schema Default

Query

q
optional

Locality name

string

Query

skip
optional

Amount of localities to skip

integer (int32)

Query

take
optional

Amount of localities to return

integer (int32)

20

Responses

HTTP Code Description Schema

200

Success

Address.Library.AddressSearchResult<RealLocality>

500

Internal server error

No Content

Produces

  • application/json

Tags

  • Address

Example HTTP response

Response 200
{
                  "data" : [ {
                    "data" : {
                      "addressCount" : 308127,
                      "buildingsCount" : 0,
                      "deliveryAreaId" : 16405,
                      "deliveryAreaName" : "3",
                      "distinctDeliveryAreaCount" : 242,
                      "districtId" : 10,
                      "districtName" : "Vilniaus",
                      "guid" : "0d39894f-62f3-4b43-8f8c-4fe7d79c6026",
                      "id" : 44,
                      "municipalityId" : 103,
                      "municipalityName" : "Vilniaus m. sav.",
                      "name" : "Vilnius",
                      "name2" : "Vilniaus",
                      "postId" : 1800,
                      "postName" : "Lentvario paštas",
                      "streetsAndBuildingsCount" : 77325,
                      "streetsCount" : 2877,
                      "subsLocalType" : 1,
                      "type" : "City"
                    },
                    "type" : "localities"
                  } ],
                  "skip" : 0,
                  "take" : 20,
                  "total" : 1
                }

4.6. Gathers information about streets in specified locality.

GET /api/v2/address/lt/reallocalities/{reallocalityId}/streets

Parameters

Type Name Description Schema Default

Path

reallocalityId
required

Locality Id

integer (int32)

Query

q
optional

Street name

string

Query

skip
optional

Amount of streets to skip

integer (int32)

Query

take
optional

Amount of streets to return

integer (int32)

20

Responses

HTTP Code Description Schema

200

Success

Address.Library.AddressSearchResult<Street>

500

Internal server error

No Content

Produces

  • application/json

Tags

  • Address

Example HTTP response

Response 200
{
                  "data" : [ {
                    "data" : {
                      "id" : 1015000,
                      "name" : "Juozo Balčikonio g."
                    },
                    "type" : "streets"
                  } ],
                  "skip" : 0,
                  "take" : 20,
                  "total" : 1
                }

4.7. Gathers information about addresses in specified locality and street.

GET /api/v2/address/lt/reallocalities/{reallocalityId}/streets/{streetId}/addresses

Parameters

Type Name Description Schema Default

Path

reallocalityId
required

Locality Id

integer (int32)

Path

streetId
required

Street Id

integer (int32)

Query

buildingNr
optional

Building number

string

Query

skip
optional

Amount of addresses to skip

integer (int32)

Query

take
optional

Amount of addresses to return

integer (int32)

20

Responses

HTTP Code Description Schema

200

Success

Address.Library.AddressSearchResult<AddressInfo>

500

Internal server error

No Content

Produces

  • application/json

Tags

  • Address

Example HTTP response

Response 200
{
                  "data" : [ {
                    "data" : {
                      "address" : "Juozo Balčikonio g. 3, Vilnius, Vilniaus m. sav. 08247",
                      "addressCount" : 137,
                      "buildId" : 1077394,
                      "buildingNr" : "3",
                      "deliveryAreaId" : 23691,
                      "deliveryAreaName" : "13",
                      "deliveryPostOfficeId" : 16516,
                      "deliveryPostOfficeName" : "Vilniaus Jeruzalės siuntų centras",
                      "deliveryZoneId" : 1,
                      "districtId" : 10,
                      "districtName" : "Vilniaus",
                      "geoLocation" : {
                        "lat" : 54.719491,
                        "lon" : 25.28543
                      },
                      "guid" : "455f220b-082e-4816-9d68-ba9998763cc1",
                      "id" : 1077394,
                      "localityId" : 44,
                      "localityName" : "Vilnius",
                      "municipalityId" : 103,
                      "municipalityName" : "Vilniaus m. sav.",
                      "orderId" : 362504,
                      "postCode" : "08247",
                      "postCodeId" : 109303,
                      "postId" : 1885,
                      "postName" : "Vilniaus 57-asis paštas",
                      "postOfficeCode" : "08013",
                      "streetId" : 31097,
                      "streetName" : "Juozo Balčikonio g."
                    },
                    "type" : "addresses"
                  } ],
                  "skip" : 0,
                  "take" : 20,
                  "total" : 1
                }

4.3. Definitions

4.3.1. Address.Library.AddressInfo

Name Schema

address
optional

string

addressCount
optional

integer (int32)

buildId
optional

integer (int32)

buildingNr
optional

string

deliveryAreaId
optional

integer (int32)

deliveryAreaName
optional

string

deliveryPostOfficeId
optional

integer (int32)

deliveryPostOfficeName
optional

string

deliveryZoneId
optional

integer (int32)

districtId
optional

integer (int32)

districtName
optional

string

geoLocation
optional

Address.Library.GeoPoint

guid
optional

string (uuid)

id
optional

integer (int32)

localityId
optional

integer (int32)

localityName
optional

string

municipalityId
optional

integer (int32)

municipalityName
optional

string

orderId
optional

integer (int32)

postCode
optional

string

postCodeId
optional

integer (int32)

postId
optional

integer (int32)

postName
optional

string

postOfficeCode
optional

string

streetId
optional

integer (int32)

streetName
optional

string

subDistrictId
optional

integer (int32)

subDistrictName
optional

string

4.3.2. Address.Library.AddressLinks

Name Schema

addresses
optional

string

buildings
optional

string

deliveryAreas
optional

string

districts
optional

string

localities
optional

string

munics
optional

string

parent
optional

string

postCodes
optional

string

postOffices
optional

string

self
optional

string

streets
optional

string

subdistricts
optional

string

4.3.3. Address.Library.AddressSearchResult<AddressInfo>

Name Schema

data
optional

< Address.Library.Result<AddressInfo> > array

skip
optional

integer (int32)

take
optional

integer (int32)

total
optional

integer (int32)

4.3.4. Address.Library.AddressSearchResult<Munic>

Name Schema

data
optional

< Address.Library.Result<Munic> > array

skip
optional

integer (int32)

take
optional

integer (int32)

total
optional

integer (int32)

4.3.5. Address.Library.AddressSearchResult<PostCode>

Name Schema

data
optional

< Address.Library.Result<PostCode> > array

skip
optional

integer (int32)

take
optional

integer (int32)

total
optional

integer (int32)

4.3.6. Address.Library.AddressSearchResult<PostOffice>

Name Schema

data
optional

< Address.Library.Result<PostOffice> > array

skip
optional

integer (int32)

take
optional

integer (int32)

total
optional

integer (int32)

4.3.7. Address.Library.AddressSearchResult<RealLocality>

Name Schema

data
optional

< Address.Library.Result<RealLocality> > array

skip
optional

integer (int32)

take
optional

integer (int32)

total
optional

integer (int32)

4.3.8. Address.Library.AddressSearchResult<Street>

Name Schema

data
optional

< Address.Library.Result<Street> > array

skip
optional

integer (int32)

take
optional

integer (int32)

total
optional

integer (int32)

4.3.9. Address.Library.DeliveryArea

Name Schema

geoArea
optional

Address.Library.GeoArea

geoCenterLocation
optional

Address.Library.GeoPoint

id
optional

integer (int32)

isActive
optional

boolean

name
optional

integer (int32)

postId
optional

integer (int32)

postName
optional

string

postOfficeCode
optional

string

types
optional

< Address.Library.DeliveryAreaType > array

validDate
optional

string (date-time)

4.3.10. Address.Library.DeliveryAreaType

Type : enum (Mobile, Motorized, Bicycle, IsTablet)

4.3.11. Address.Library.GeoArea

Name Schema

geoPoint
optional

< Address.Library.GeoPoint > array

4.3.12. Address.Library.GeoPoint

Name Schema

lat
optional

number (double)

lon
optional

number (double)

4.3.13. Address.Library.LocalityType

Type : enum (Other, City, Town, Village)

4.3.14. Address.Library.Munic

Name Schema

id
optional

integer (int32)

name
optional

string

4.3.15. Address.Library.PostCode

Name Schema

deliveryZoneId
optional

integer (int32)

firstLocalityId
optional

integer (int32)

geoArea
optional

Address.Library.GeoArea

geoCenterLocation
optional

Address.Library.GeoPoint

id
optional

integer (int32)

name
optional

string

postId
optional

integer (int32)

postName
optional

string

postPostCode
optional

string

type
optional

Address.Library.PostCodeType

4.3.16. Address.Library.PostCodeType

Type : enum (Post, PostBox, Address, BigCustomer)

4.3.17. Address.Library.PostOffice

Name Schema

countyId
optional

integer (int32)

countyName
optional

string

districtId
optional

integer (int32)

districtName
optional

string

flags
optional

< Address.Library.PostOfficeFlag > array

geoArea
optional

Address.Library.GeoArea

geoLocation
optional

Address.Library.GeoPoint

id
optional

integer (int32)

localityId
optional

integer (int32)

localityName
optional

string

localityNameV
optional

string

localityType
optional

Address.Library.LocalityType

masterPostId
optional

integer (int32)

municipalityId
optional

integer (int32)

municipalityName
optional

string

name
optional

string

postAddress
optional

string

postBuildId
optional

integer (int32)

postCode
optional

string

retailType
optional

integer (int32)

subDistrictId
optional

integer (int32)

subDistrictName
optional

string

terminalCode
optional

string

type
optional

Address.Library.PostType

4.3.18. Address.Library.PostOfficeFlag

Type : enum (PayPost, CentralPost, CourierPost, ComputerizedPost, Terminal, SalePost, TempPost, DeliveryOffice)

4.3.19. Address.Library.PostType

Type : enum (CountyPost, TransportationPost, StandardPost, CityPost, AreaPost, VirtualPost, CourierPost, ExchangePost, UPPPost, Terminal)

4.3.20. Address.Library.RealLocality

Name Schema

address
optional

string

addressCount
optional

integer (int32)

buildingsCount
optional

integer (int32)

deliveryAreaId
optional

integer (int32)

deliveryAreaName
optional

string

deliveryZoneId
optional

integer (int32)

distinctDeliveryAreaCount
optional

integer (int32)

districtId
optional

integer (int32)

districtName
optional

string

geoArea
optional

Address.Library.GeoArea

geoCenterLocation
optional

Address.Library.GeoPoint

guid
optional

string (uuid)

id
optional

integer (int32)

municipalityId
optional

integer (int32)

municipalityName
optional

string

name
optional

string

name2
optional

string

name2Lower
optional

string

nameLower
optional

string

postId
optional

integer (int32)

postName
optional

string

streetsAndBuildingsCount
optional

integer (int32)

streetsCount
optional

integer (int32)

subDistrictId
optional

integer (int32)

subDistrictName
optional

string

subsLocalType
optional

integer (int32)

type
optional

Address.Library.LocalityType

4.3.21. Address.Library.Result<AddressInfo>

Name Schema

activeStats
optional

Address.Library.Stats

data
optional

Address.Library.AddressInfo

links
optional

Address.Library.AddressLinks

type
optional

string

4.3.22. Address.Library.Result<Locality>

Name Schema

activeStats
optional

Address.Library.Stats

data
optional

Address.Library.Locality

links
optional

Address.Library.AddressLinks

type
optional

string

4.3.23. Address.Library.Result<Munic>

Name Schema

activeStats
optional

Address.Library.Stats

data
optional

Address.Library.Munic

links
optional

Address.Library.AddressLinks

type
optional

string

4.3.24. Address.Library.Result<PostCode>

Name Schema

activeStats
optional

Address.Library.Stats

data
optional

Address.Library.PostCode

links
optional

Address.Library.AddressLinks

type
optional

string

4.3.25. Address.Library.Result<PostOffice>

Name Schema

activeStats
optional

Address.Library.Stats

data
optional

Address.Library.PostOffice

links
optional

Address.Library.AddressLinks

type
optional

string

4.3.26. Address.Library.Result<RealLocality>

Name Schema

activeStats
optional

Address.Library.Stats

data
optional

Address.Library.RealLocality

links
optional

Address.Library.AddressLinks

type
optional

string

4.3.27. Address.Library.Result<Street>

Name Schema

activeStats
optional

Address.Library.Stats

data
optional

Address.Library.Street

links
optional

Address.Library.AddressLinks

type
optional

string

4.3.28. Address.Library.Stats

Name Schema

addresses
optional

integer (int32)

buildings
optional

integer (int32)

deliveryAreas
optional

integer (int32)

districts
optional

integer (int32)

localities
optional

integer (int32)

munics
optional

integer (int32)

postCodes
optional

integer (int32)

postOffices
optional

integer (int32)

streets
optional

integer (int32)

subdistricts
optional

integer (int32)

4.3.29. Address.Library.Street

Name Schema

id
optional

integer (int32)

name
optional

string

5. Tracking

Possibility to track some of the items by barcode depends on which plan you have selected. When parcel are delivered (PARCEL_DELIVERED) or cancelled (PARCEL_CANCELED) we recommend to stop tracking because there will be no new events anyway. Tracking main status is returned in publicStateType field.

Plan Code Destination country Trackable

UNTRACKED

ANY

false

SIGNED

LT

true

SIGNED

ANY except LT

false

TERMINAL

LT,LV,EE

true

TERMINAL

ANY except LT

false

TRACKED

ANY except LT

true

HANDS

ANY

true

5.1. Paths

5.2 Used to modify personal configuration.

POST /api/v2/tracking/configurations

Description

To configure which events to return fill in publishEvents array with preferred event types. If array is set to null all event types will be included in /events GET response.

Parameters

Type Name Schema

Body

body
optional

PublishConfigurationInfo

Responses

HTTP Code Description Schema

200

Success. Configuration has been updated successfully

No Content

401

Unauthorized or missing authorization token

No Content

500

Internal server error

No Content

Consumes

  • application/json

5.3 Gathers events for the specified mail.

POST /api/v2/tracking/events

Parameters

Type Name Description Schema

Header

Accept-Language
optional

Preferred languages of events returned.

string

Query

dateFrom
optional

Date and time (inclusive) from which events will be returned.

string

Body

body
optional

< string > array

Responses

HTTP Code Description Schema

200

Success. Returns an array of mail events.

< SavitarnaPublicEventInfo > array

401

Unauthorized or missing authorization token.

No Content

500

Internal server error

No Content

Consumes

  • application/json

Produces

  • application/json

Tags

  • Events

Security

Type Name

apiKey

BearerAuth

Example HTTP response

Response 200
[ {
                  "countryCode" : "LT",
                  "eventDate" : "2023-07-26T02:52:02",
                  "id" : "6a81756a-e847-e1b8-377c-8403f29f8442",
                  "mailBarcode" : "CE498174684LT",
                  "publicEventText" : "Siuntos žyma atšaukta",
                  "publicEventType" : "LABEL_CANCELLED",
                  "publicStateText" : "Siunta atšaukta",
                  "publicStateType" : "PARCEL_CANCELED"
                } ]

5.4 Gathers events for the specified mail.

GET /api/v2/tracking/{barcode}/events

Parameters

Type Name Description Schema

Header

Accept-Language
optional

Preferred languages of events returned.

string

Path

barcode
required

Mail barcode

string

Responses

HTTP Code Description Schema

200

Success. Returns an array of mail events.

< SavitarnaPublicEventInfo > array

401

Unauthorized or missing authorization token.

No Content

500

Internal server error

No Content

Produces

  • application/json

Tags

  • Events

Security

Type Name

apiKey

BearerAuth

Example HTTP response

Response 200
[ {
                  "countryCode" : "LT",
                  "eventDate" : "2023-07-26T02:52:02",
                  "id" : "6a81756a-e847-e1b8-377c-8403f29f8442",
                  "mailBarcode" : "CE498174684LT",
                  "publicEventText" : "Siuntos žyma atšaukta",
                  "publicEventType" : "LABEL_CANCELLED",
                  "publicStateText" : "Siunta atšaukta",
                  "publicStateType" : "PARCEL_CANCELED"
                } ]

5.5. Public event types table

PublicEventType

PublicStateType

PublicStateText

LABEL_CREATED

LABEL_CREATED

Siunta sukurta

CUSTOMS_AWAITING_PAYMENT

ON_THE_WAY

Siunta kelyje

CUSTOMS_DECLARATION_REQUIRED

ON_THE_WAY

Siunta kelyje

CUSTOMS_DECLARATION_REVIEW_PENDING

ON_THE_WAY

Siunta kelyje

CUSTOMS_DECLARATION_SUBMITTED

ON_THE_WAY

Siunta kelyje

CUSTOMS_EDB

ON_THE_WAY

Siunta kelyje

CUSTOMS_EDC

ON_THE_WAY

Siunta kelyje

CUSTOMS_EME

ON_THE_WAY

Siunta kelyje

CUSTOMS_EXA

ON_THE_WAY

Siunta kelyje

CUSTOMS_EXB

ON_THE_WAY

Siunta kelyje

CUSTOMS_EXC

ON_THE_WAY

Siunta kelyje

CUSTOMS_ON_HOLD

ON_THE_WAY

Siunta kelyje

CUSTOMS_PREPAID

ON_THE_WAY

Siunta kelyje

DELIVERY_EDA

ON_THE_WAY

Siunta kelyje

DELIVERY_EDD

ON_THE_WAY

Siunta kelyje

DELIVERY_EDE

ON_THE_WAY

Siunta kelyje

DELIVERY_EDF

ON_THE_WAY

Siunta kelyje

DELIVERY_EDH

ON_THE_WAY

Siunta kelyje

DELIVERY_EXD

ON_THE_WAY

Siunta kelyje

DELIVERY_EXPORTED

ON_THE_WAY

Siunta kelyje

DELIVERY_EXX

ON_THE_WAY

Siunta kelyje

DELIVERY_HOLDING

ON_THE_WAY

Siunta kelyje

DELIVERY_PARCEL_LOST

ON_THE_WAY

Siunta kelyje

DELIVERY_REDIRECTING

ON_THE_WAY

Siunta kelyje

DELIVERY_STORING

ON_THE_WAY

Siunta kelyje

DELIVERY_TRANSFER

ON_THE_WAY

Siunta kelyje

DELIVERY_TRANSFER2

ON_THE_WAY

Siunta kelyje

DELIVERY_UNSUCCESSFUL_DELIVERY

ON_THE_WAY

Siunta kelyje

DEPARTED_RECEIVER_LC

ON_THE_WAY

Siunta kelyje

EXPORT_PENDING

ON_THE_WAY

Siunta kelyje

HANDED_TO_GOVERNMENT

ON_THE_WAY

Siunta kelyje

NOTIFICATIONS_PDA_UNABLE_TO_CONTACT

ON_THE_WAY

Siunta kelyje

ORDERS_PARCEL_DEMAND

ON_THE_WAY

Siunta kelyje

RECEIVED_DELIVERY_POST

ON_THE_WAY

Siunta kelyje

RECEIVED_RECEIVER_LC

ON_THE_WAY

Siunta kelyje

RECEIVED_SENDER_LC

ON_THE_WAY

Siunta kelyje

RECEIVED_LC

ON_THE_WAY

Siunta kelyje

RECEIVED_TERMINAL

ON_THE_WAY

Siunta kelyje

RECEIVED_TERMINAL_OUT

ON_THE_WAY

Siunta kelyje

TRANSFERRED_FOR_DELIVERY_COURIER

ON_THE_WAY

Siunta kelyje

TRANSFERRED_FOR_DELIVERY_POSTMAN

ON_THE_WAY

Siunta kelyje

TRANSIT_EMJ

ON_THE_WAY

Siunta kelyje

TRANSIT_EMK

ON_THE_WAY

Siunta kelyje

NOTIFICATIONS_INFORMED

ON_THE_WAY

Siunta kelyje

LABEL_CANCELLED

PARCEL_CANCELED

Siunta atšaukta

DELIVERY_DELIVERED

PARCEL_DELIVERED

Siunta pristatyta

ACCEPTED

PARCEL_RECEIVED

Siunta priimta

ACCEPTED_TERMINAL

PARCEL_RECEIVED

Siunta priimta

DELIVERY_RETURNED

RETURNING

Siunta grąžinama

DELIVERY_DESTROY

RETURNING

Siunta grąžinama

DELIVERY_REFUNDING

RETURNING

Siunta grąžinama

5.2. Definitions

5.2.1. PublishConfigurationInfo

Name Schema

authToken
optional

string

maxCount
optional

integer (int32)

publishEvents
optional

< string > array

url
optional

string

5.2.2. SavitarnaPublicEventInfo

Name Schema

countryCode
optional

string

eventDate
optional

string (date-time)

id
optional

string (uuid)

location
optional

string

mailBarcode
optional

string

publicEventText
optional

string

publicEventType
optional

string

publicStateText
optional

string

publicStateType
optional

string