UNISEND LP EXPRESS API

https://www.post.lt/savitarna/api_doc.html
Admin
UNISEND (LP EXPRESS) is an open API for managing shipping items, parcels, and courier services with...
Tokens:39,681
Snippets:200
Trust Score:9.1
Update:6 months ago
Show doc for...
Tokens:
Raw
### Estimate Shipping Plan (curl)

Source: https://www.post.lt/savitarna/api_doc.html

This example demonstrates how to estimate shipping plan details by making a GET request to the shipping estimate endpoint. It allows specifying sender and receiver country codes to find suitable shipping methods.

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

--------------------------------

### Example Response for Street Data - JSON

Source: https://www.post.lt/savitarna/api_doc.html

An example JSON response for a successful request to retrieve street information within a locality. It includes the street ID and name.

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

--------------------------------

### Example Response for Locality Data - JSON

Source: https://www.post.lt/savitarna/api_doc.html

An example JSON response for a successful request to retrieve locality information. It includes details like address counts, building counts, and locality names.

```JSON
{
                  "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 
                }
```

--------------------------------

### GET /api/v2/sticker/list

Source: https://www.post.lt/savitarna/api_doc.html

Retrieves stickers for initiated shipping items.

```APIDOC
## GET /api/v2/sticker/list

### Description
To get stickers for initiated shipping items.

### Method
GET

### Endpoint
/api/v2/sticker/list

### Parameters
#### Query Parameters
- **parcelIds** (Long) - Required - Unique identifier of a shipping item.
- **layout** (string) - Required - The format of shipping item sticker layout across the page.
- **labelOrientation** (string) - Optional - PORTRAIT or LANDSCAPE orientation may be applied for the sticker.
- **idRefs** (String) - Required - Unique identifier of a shipping item.

### Request Example
```json
{
  "example": "[Request Body Example]"
}
```

### Response
#### Success Response (200)
- **array[_ShippingItemLabel_]** - Shipping item label entity which represent label item.

#### Response Example
```json
{
  "example": "array[_ShippingItemLabel_]"
}
```
```

--------------------------------

### GET /api/v2/sticker/pdf

Source: https://www.post.lt/savitarna/api_doc.html

Generates a shipping sticker in PDF format.

```APIDOC
## GET /api/v2/sticker/pdf

### Description
Generates a printable PDF sticker for the specified parcel.

### Method
GET

### Endpoint
/api/v2/sticker/pdf

### Parameters
#### Query Parameters
- **parcelIds** (string) - Optional - The parcel ID for the sticker.
- **idRefs** (string) - Optional - The idRef for the sticker.
- **layout** (string) - Required - The layout format (e.g., LAYOUT_10x15).
```

--------------------------------

### Courier to Parcel Locker Shipment

Source: https://www.post.lt/savitarna/api_doc.html

This example shows how to create a shipment for delivery by courier to a parcel locker.

```APIDOC
## POST /shipments

### Description
Creates a new shipment request for delivery by courier to a parcel locker.

### Method
POST

### Endpoint
/shipments

### Parameters
#### Request Body
- **plan** (object) - Required - Shipping plan details.
  - **code** (string) - Required - The code for the shipping plan (e.g., "TERMINAL").
- **parcel** (object) - Required - Parcel details.
  - **type** (string) - Required - Type of parcel service (e.g., "H2T").
  - **size** (string) - Required - Size of the parcel (e.g., "XS").
- **receiver** (object) - Required - Receiver details.
  - **name** (string) - Required - Receiver's full name.
  - **companyName** (string) - Optional - Receiver's company name.
  - **address** (object) - Required - Receiver's address.
    - **countryCode** (string) - Required - Two-letter country code (e.g., "LT").
    - **terminalId** (string) - Required - ID of the destination parcel locker.
  - **contacts** (object) - Required - Receiver's contact information.
    - **phone** (string) - Required - Receiver's phone number.

### Request Example
```json
{
  "plan": {
    "code": "TERMINAL"
  },
  "parcel": {
    "type":"H2T",
    "size": "XS"
  },
  "receiver": {
    "name": "Test Name",
    "companyName": "Test lastName",
    "address" : {
      "countryCode": "LT",
      "terminalId": "0137"
    },
    "contacts":{
      "phone":"+37000000000"
    }
  }
}
```

### Response
#### Success Response (200)
- **status** (string) - The status of the shipment creation.
- **shipmentId** (string) - The unique identifier for the created shipment.

#### Response Example
```json
{
  "status": "created",
  "shipmentId": "shp_12345abcde"
}
```
```

--------------------------------

### GET /api/v2/terminal

Source: https://www.post.lt/savitarna/api_doc.html

Retrieves a list of terminals based on the provided query parameters. It's used to get shipping available data.

```APIDOC
## GET /api/v2/terminal

### Description
Retrieves a list of terminals. This endpoint is used to get shipping available data.

### Method
GET

### Endpoint
/api/v2/terminal

### Parameters
#### Query Parameters
- **receiverCountryCode** (string) - Required - Description: None provided.
- **senderCountryCode** (string) - Optional - Description: None provided.
- **size** (integer) - Optional - Description: None provided.

### Responses
#### Success Response (200)
- **ShippingAvailableResult** (object) - Shipping available data structure.
#### Error Response (400)
- **ErrorResponse** (object) - Bad Request.
#### Error Response (401)
- **object** - Unauthorized.
#### Error Response (403)
- **object** - Forbidden.
#### Error Response (500)
- **ErrorResponse** (object) - Internal Server Error.
```

--------------------------------

### Get PDF Stickers by Parcel IDs (GET /api/v2/sticker/pdf)

Source: https://www.post.lt/savitarna/api_doc.html

Retrieves PDF stickers for specified shipping items. Supports various layouts, orientations, and options for including CN23 forms and manifests. Requires parcelIds and layout as query parameters.

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

```curl
curl --location --request GET 'GET /api/v2/sticker/pdf?parcelIds={{parcelId}}&layout=LAYOUT_10x15&labelOrientation=PORTRAIT&includeCn23=false&includeManifest=false'
```

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

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

--------------------------------

### GET /api/v2/sticker/spd/list

Source: https://www.post.lt/savitarna/api_doc.html

Retrieves SPD stickers for initiated shipping items.

```APIDOC
## GET /api/v2/sticker/spd/list

### Description
To get SPD stickers for initiated shipping items.

### Method
GET

### Endpoint
/api/v2/sticker/spd/list

### Parameters
#### Query Parameters
- **parcelIds** (Long) - Required - Unique identifier of a shipping item.
- **idRefs** (String) - Required - Unique identifier of a shipping item ID ref.

### Request Example
```json
{
  "example": "curl --location --request GET 'GET /api/v2/sticker/spd/list?parcelIds={{parcelId}}'"
}
```

### Response
#### Success Response (200)
- **array[_ShippingItemLabel_]** - Shipping item label entity which represent label item.

#### Response Example
```json
{
  "example": "List[_ShippingItemLabel_]"
}
```
```

--------------------------------

### Parcel Locker to Parcel Locker Shipment

Source: https://www.post.lt/savitarna/api_doc.html

This example demonstrates how to create a shipment from one parcel locker to another.

```APIDOC
## POST /shipments

### Description
Creates a new shipment request for parcel locker to parcel locker delivery.

### Method
POST

### Endpoint
/shipments

### Parameters
#### Request Body
- **plan** (object) - Required - Shipping plan details.
  - **code** (string) - Required - The code for the shipping plan (e.g., "TERMINAL").
- **parcel** (object) - Required - Parcel details.
  - **type** (string) - Required - Type of parcel service (e.g., "T2T").
  - **size** (string) - Required - Size of the parcel (e.g., "S").
- **receiver** (object) - Required - Receiver details.
  - **name** (string) - Required - Receiver's full name.
  - **companyName** (string) - Optional - Receiver's company name.
  - **address** (object) - Required - Receiver's address.
    - **countryCode** (string) - Required - Two-letter country code (e.g., "LT").
    - **locality** (string) - Required - City or locality.
    - **terminalId** (string) - Required - ID of the destination parcel locker.
  - **contacts** (object) - Required - Receiver's contact information.
    - **phone** (string) - Required - Receiver's phone number.

### Request Example
```json
{
  "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"
    }
  }
}
```

### Response
#### Success Response (200)
- **status** (string) - The status of the shipment creation.
- **shipmentId** (string) - The unique identifier for the created shipment.

#### Response Example
```json
{
  "status": "created",
  "shipmentId": "shp_12345abcde"
}
```
```

--------------------------------

### Get Stickers by Parcel IDs (GET /api/v2/sticker/list)

Source: https://www.post.lt/savitarna/api_doc.html

Retrieves general stickers for initiated shipping items. This endpoint requires parcelIds and layout, and supports optional label orientation.

```curl
curl --location --request GET 'GET /api/v2/sticker/list?parcelIds={{parcelId}}&layout={{layout}}&labelOrientation={{labelOrientation}}&idRefs={{idRefs}}'
```

--------------------------------

### Address API Response Example

Source: https://www.post.lt/savitarna/api_doc.html

A sample JSON response body returned by the Address API, demonstrating the structure of the AddressInfo object within a search result.

```json
{
  "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
}
```

--------------------------------

### Get CN PDF

Source: https://www.post.lt/savitarna/api_doc.html

Retrieves the PDF labels for initiated shipping items.

```APIDOC
## GET /api/v2/documents/cn/pdf

### Description
To get CN labels for initiated shipping items.

### Method
GET

### Endpoint
/api/v2/documents/cn/pdf

### Parameters
#### Query Parameters
- **parcelIds** (Long) - Required - Unique identifier of a shipping item.
- **idRefs** (String) - Required - Unique identifier of a shipping item.

### Response
#### Success Response (200)
- **[Object]** (Object) - The CN PDF document.

#### Response Example
```json
{
  "example": "CN PDF document"
}
```
```

--------------------------------

### Request Body for PRODUCT_RETURN Service

Source: https://www.post.lt/savitarna/api_doc.html

Example JSON request body for creating a shipment with an additional PRODUCT_RETURN service label. This is used to facilitate return logistics for parcels.

```json
{
  "plan": {
    "code": "TERMINAL"
  },
  "parcel": {
    "type": "H2T",
    "size": "XS"
  },
  "services": [{
    "code": "PRODUCT_RETURN"
  }],
  "receiver": {
    "name": "test name",
    "address": {
      "countryCode": "LT",
      "terminalId": "0101"
    },
    "contacts": {
      "phone": "+37060000000"
    }
  }
}
```

--------------------------------

### Courier to Receiver Address Shipment

Source: https://www.post.lt/savitarna/api_doc.html

This example illustrates creating a shipment for direct delivery by courier to a receiver's address.

```APIDOC
## POST /shipments

### Description
Creates a new shipment request for direct delivery by courier to a receiver's address.

### Method
POST

### Endpoint
/shipments

### Parameters
#### Request Body
- **plan** (object) - Required - Shipping plan details.
  - **code** (string) - Required - The code for the shipping plan (e.g., "HANDS").
- **parcel** (object) - Required - Parcel details.
  - **type** (string) - Required - Type of parcel service (e.g., "H2H").
  - **weight** (string) - Required - Weight of the parcel in grams (e.g., "9000").
- **receiver** (object) - Required - Receiver details.
  - **name** (string) - Required - Receiver's full name.
  - **companyName** (string) - Optional - Receiver's company name.
  - **address** (object) - Required - Receiver's address.
    - **countryCode** (string) - Required - Two-letter country code (e.g., "LT").
    - **locality** (string) - Required - City or locality.
    - **postalCode** (string) - Required - Postal code.
    - **street** (string) - Required - Street name.
    - **building** (string) - Required - Building number.
  - **contacts** (object) - Required - Receiver's contact information.
    - **phone** (string) - Required - Receiver's phone number.
    - **email** (string) - Optional - Receiver's email address.

### Request Example
```json
{
  "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"
    }
  }
}
```

### Response
#### Success Response (200)
- **status** (string) - The status of the shipment creation.
- **shipmentId** (string) - The unique identifier for the created shipment.

#### Response Example
```json
{
  "status": "created",
  "shipmentId": "shp_12345abcde"
}
```
```

--------------------------------

### Tracked Shipment with Customs Declaration

Source: https://www.post.lt/savitarna/api_doc.html

This example shows how to create a tracked shipment that includes customs declaration details like HS code and country of origin.

```APIDOC
## POST /shipments

### Description
Creates a new tracked shipment request, including details for customs declaration such as HS code and country of origin.

### Method
POST

### Endpoint
/shipments

### Parameters
#### Request Body
- **plan** (object) - Required - Shipping plan details.
  - **code** (string) - Required - The code for the shipping plan (e.g., "TRACKED").
- **parcel** (object) - Required - Parcel details.
  - **type** (string) - Required - Type of parcel service (e.g., "P2H").
  - **size** (string) - Optional - Size of the parcel (e.g., "M").
  - **weight** (string) - Required - Weight of the parcel in grams (e.g., "2000").
- **services** (array) - Optional - List of additional services.
- **receiver** (object) - Required - Receiver details.
  - **name** (string) - Required - Receiver's full name.
  - **address** (object) - Required - Receiver's address.
    - **countryCode** (string) - Required - Two-letter country code (e.g., "US").
    
### Request Example
```json
{
  "plan": {
    "code": "TRACKED"
  },
  "parcel": {
    "type":"P2H",
    "size":"M",
    "weight":"2000"
  },
  "services": [
  ],
  "receiver": {
    "name": "test name",
    "address": {
      "countryCode": "US"
    }
  }
}
```

### Response
#### Success Response (200)
- **status** (string) - The status of the shipment creation.
- **shipmentId** (string) - The unique identifier for the created shipment.

#### Response Example
```json
{
  "status": "created",
  "shipmentId": "shp_12345abcde"
}
```
```

--------------------------------

### Estimate Shipping Cost Response

Source: https://www.post.lt/savitarna/api_doc.html

Example JSON response from the shipping estimation endpoint, providing the calculated price and currency.

```json
[
  {
    "id": "123",
    "price": {
      "amount": 8.45,
      "currency": "EUR"
    }
  }
]
```

--------------------------------

### GET /api/v2/sticker/pdf

Source: https://www.post.lt/savitarna/api_doc.html

Retrieves sticker PDFs for initiated shipping items. Supports various layout and orientation options.

```APIDOC
## GET /api/v2/sticker/pdf

### Description
To get stickers PDF. To get stickers for initiated shipping items.

### Method
GET

### Endpoint
/api/v2/sticker/pdf

### Parameters
#### Query Parameters
- **parcelIds** (Long) - Required - Unique identifier of a shipping item.
- **layout** (string) - Required - The format of shipping item sticker layout across the page.
- **labelOrientation** (string) - Optional - PORTRAIT or LANDSCAPE orientation may be applied for the sticker.
- **includeCn23** (boolean) - Optional - Include CN23 forms into response. Default: true.
- **includeManifest** (boolean) - Optional - Include manifest into response. Default: false.
- **idRefs** (String) - Required - Unique identifier of a shipping item.

### Request Example
```json
{
  "example": "curl --location --request GET 'GET /api/v2/sticker/pdf?parcelIds={{parcelId}}&layout=LAYOUT_10x15&labelOrientation=LANDSCAPE'"
}
```

### Response
#### Success Response (200)
- **[Object]** - OK

#### Response Example
```json
{
  "example": "[Object]"
}
```
```

--------------------------------

### GET /duty/estimate/price

Source: https://www.post.lt/savitarna/api_doc.html

Retrieves estimated customs duty and administration fees for shipments, specifically required for USA destinations.

```APIDOC
## GET /duty/estimate/price

### Description
Calculates the customs duty and administration fees for a shipment. This is essential for users shipping to the USA to ensure compliance with duty payment consent.

### Method
GET

### Endpoint
/duty/estimate/price

### Parameters
#### Query Parameters
- **destination_country** (string) - Required - ISO country code of the destination.
- **parcel_value** (decimal) - Required - Declared value of the parcel contents.

### Response
#### Success Response (200)
- **duty_fee** (decimal) - Estimated customs duty amount.
- **admin_fee** (decimal) - Estimated administration fee.
- **total_fee** (decimal) - Combined total fees.

#### Response Example
{
  "duty_fee": 5.50,
  "admin_fee": 2.00,
  "total_fee": 7.50
}
```

--------------------------------

### GET /api/v2/sticker/list

Source: https://www.post.lt/savitarna/api_doc.html

Retrieves a list of shipping item labels based on parcel IDs and layout preferences.

```APIDOC
## GET /api/v2/sticker/list

### Description
Retrieves shipping labels for specified parcels.

### Method
GET

### Endpoint
/api/v2/sticker/list

### Parameters
#### Query Parameters
- **parcelIds** (string) - Required - The IDs of the parcels to retrieve labels for.
- **layout** (string) - Required - The layout format (e.g., LAYOUT_10x15).
- **labelOrientation** (string) - Required - The orientation (LANDSCAPE or PORTRAIT).

### Response
#### Success Response (200)
- **List[ShippingItemLabel]** - List of shipping item label entities.
```

--------------------------------

### GET /addresses

Source: https://www.post.lt/savitarna/api_doc.html

Retrieves a list of addresses based on search criteria, returning detailed address information and metadata.

```APIDOC
## GET /addresses

### Description
Retrieves a paginated list of address records matching the search criteria.

### Method
GET

### Endpoint
/addresses

### Parameters
#### Query Parameters
- **skip** (integer) - Optional - Number of records to skip for pagination.
- **take** (integer) - Optional - Number of records to return.

### Response
#### Success Response (200)
- **data** (array) - List of address objects.
- **skip** (integer) - Number of records skipped.
- **take** (integer) - Number of records returned.
- **total** (integer) - Total number of records found.

#### Response Example
{
  "data": [
    {
      "data": {
        "address": "Juozo Balčikonio g. 3, Vilnius, Vilniaus m. sav. 08247",
        "buildId": 1077394,
        "postCode": "08247",
        "streetName": "Juozo Balčikonio g."
      },
      "type": "addresses"
    }
  ],
  "skip": 0,
  "take": 20,
  "total": 1
}
```

--------------------------------

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

Source: https://www.post.lt/savitarna/api_doc.html

Retrieves the status of a shipping order using the request ID.

```APIDOC
## GET /api/v2/shipping/status/{requestId}

### Description
Checks the status of the shipment creation and retrieves tracking information.

### Method
GET

### Endpoint
/api/v2/shipping/status/{requestId}

### Parameters
#### Path Parameters
- **requestId** (string) - Required - The ID returned from the initiation step.

### Response
#### Success Response (200)
- **status** (string) - Current status of the shipment.
- **items** (array) - List of parcel tracking details including barcodes.
```

--------------------------------

### Courier to Receiver Address Request (JSON)

Source: https://www.post.lt/savitarna/api_doc.html

Example JSON request for shipping a parcel via courier directly to a receiver's address. Includes detailed address information and contact details.

```json
{
    "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"
      }
    }
  }
```

--------------------------------

### GET /api/v2/shipping/estimate/plan

Source: https://www.post.lt/savitarna/api_doc.html

Retrieves available shipping plans and rates based on sender and receiver country codes.

```APIDOC
## GET /api/v2/shipping/estimate/plan

### Description
Estimates shipping plans, rates, and services based on the provided sender and receiver country codes.

### Method
GET

### Endpoint
/api/v2/shipping/estimate/plan

### Parameters
#### Query Parameters
- **receiverCountryCode** (string) - Required - ISO country code of the recipient
- **senderCountryCode** (string) - Required - ISO country code of the sender

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

### Response
#### Success Response (200)
- **plans** (array) - List of available shipping plans and their details
```

--------------------------------

### Estimate Shipping Cost Request

Source: https://www.post.lt/savitarna/api_doc.html

Example JSON payload for the POST /api/v2/shipping/estimate/price/list endpoint to calculate full shipping costs including customs duty.

```json
{
  "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"
        }
      ]
    }
  ]
}
```

--------------------------------

### GET /api/v2/pod/report

Source: https://www.post.lt/savitarna/api_doc.html

Retrieves a Proof of Delivery (POD) report based on a parcel ID or a specific date range.

```APIDOC
## GET /api/v2/pod/report

### Description
Get POD PDF by parcel ID or date range.

### Method
GET

### Endpoint
/api/v2/pod/report

### Parameters
#### Query Parameters
- **parcelId** (string) - Required - Unique parcel identifier
- **idRef** (string) - Required - Reference ID
- **dateFrom** (string) - Required - Start date for the report range
- **dateTo** (string) - Required - End date for the report range
```

--------------------------------

### Get Manifest PDF by Parcel ID

Source: https://www.post.lt/savitarna/api_doc.html

Retrieves the PDF version of manifests for completed shipping items.

```APIDOC
## GET /api/v2/courier/manifest/pdf

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

### Method
GET

### Endpoint
/api/v2/courier/manifest/pdf

### Parameters
#### Query Parameters
- **parcelIds** (Long) - Required - Shipping item identifier.
- **idRefs** (String) - Required - Shipping item identifier reference.

### Response
#### Success Response (200)
- **[Object]** (Object) - PDF document of the shipping item courier manifest.

#### Response Example
```json
{
  "example": "pdf document"
}
```
```

--------------------------------

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

Source: https://www.post.lt/savitarna/api_doc.html

Gathers information about addresses in a specified locality and street. Supports filtering by building number and pagination.

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

### Description
Gathers information about addresses in a specified locality and street. Supports filtering by building number and pagination.

### Method
GET

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

### Parameters
#### Path Parameters
- **reallocalityId** (integer) - Required - Locality Id
- **streetId** (integer) - Required - Street Id

#### Query Parameters
- **buildingNr** (string) - Optional - Building number
- **skip** (integer) - Optional - Amount of addresses to skip
- **take** (integer) - Optional - Amount of addresses to return (default: 20)

### Request Example
(No request body for GET requests)

### Response
#### Success Response (200)
- **data** (array) - An array of address objects.
  - **data** (object) - Contains address details.
    - **addressCount** (integer) - Number of addresses.
    - **buildingsCount** (integer) - Number of buildings.
    - **deliveryAreaId** (integer) - The ID of the delivery area.
    - **deliveryAreaName** (string) - The name of the delivery area.
    - **distinctDeliveryAreaCount** (integer) - Number of distinct delivery areas.
    - **districtId** (integer) - The ID of the district.
    - **districtName** (string) - The name of the district.
    - **guid** (string) - Unique identifier for the address.
    - **id** (integer) - The ID of the address.
    - **municipalityId** (integer) - The ID of the municipality.
    - **municipalityName** (string) - The name of the municipality.
    - **name** (string) - The name of the locality.
    - **name2** (string) - Secondary name for the locality.
    - **postId** (integer) - The ID of the post office.
    - **postName** (string) - The name of the post office.
    - **streetsAndBuildingsCount** (integer) - Total count of streets and buildings.
    - **streetsCount** (integer) - Number of streets.
    - **subsLocalType** (integer) - Type of sub-locality.
    - **type** (string) - Type of the locality (e.g., "City").
- **skip** (integer) - The number of results skipped.
- **take** (integer) - The number of results returned.
- **total** (integer) - The total number of results available.

#### Response Example
```json
{
  "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
}
```
```

--------------------------------

### Get Locality Information (API)

Source: https://www.post.lt/savitarna/api_doc.html

Retrieves information about localities, enabling searches by locality name. Supports pagination for managing the number of results. The response provides details about each locality, such as its name and type.

```HTTP
GET /api/v2/address/lt/reallocalities

# Parameters:
# q (string, optional): Locality name.
# skip (integer, optional): Amount of localities to skip.
# take (integer, optional): Amount of localities to return (default: 20).

# Example Response (200 OK):
{
  "data": [],
  "skip": 0,
  "take": 20,
  "total": 0
}
```

--------------------------------

### Estimate Customs Duty Price Response

Source: https://www.post.lt/savitarna/api_doc.html

Example JSON response body for the POST /api/v2/duty/estimate/price endpoint. It returns the calculated duty services, including amounts, fees, and currency for the requested items.

```json
[
  {
    "id": "UniqueId",
    "dutyServices": [
      {
        "amount": 150,
        "fee": 2,
        "currency": "EUR"
      },
      {
        "amount": 150,
        "fee": 2,
        "currency": "USD"
      }
    ]
  }
]
```

--------------------------------

### Get Address Information (API)

Source: https://www.post.lt/savitarna/api_doc.html

Retrieves detailed address information based on various criteria. Supports filtering and pagination. The response includes address components, geographical coordinates, and associated IDs.

```HTTP
GET /api/v2/address/lt/addresses

# Parameters:
# q (string, optional): Query for address or street name.
# skip (integer, optional): Number of results to skip.
# take (integer, optional): Number of results to return (default: 20).

# Example Response (200 OK):
{
  "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
}
```

--------------------------------

### POST /api/v2/shipping/initiate

Source: https://www.post.lt/savitarna/api_doc.html

Completes the shipment creation process and initiates the delivery.

```APIDOC
## POST /api/v2/shipping/initiate

### Description
Finalizes the preparation of the parcel and initiates the shipping process.

### Method
POST

### Endpoint
/api/v2/shipping/initiate

### Request Body
- **parcelIds** (array) - Optional - List of parcel IDs to initiate.
- **idRefs** (array) - Optional - List of idRefs to initiate.

### Response
#### Success Response (200)
- **requestId** (string) - Unique ID to track the initiation process.

### Response Example
{
  "requestId": "04d811ee-6b97-3778-95bd-ed123021001c"
}
```

--------------------------------

### GET /api/v2/courier/call/required - Check if Courier Call is Required

Source: https://www.post.lt/savitarna/api_doc.html

Checks whether a courier call is required. This is a simple GET request that returns a boolean value indicating the requirement.

```http
GET /api/v2/courier/call/required HTTP/1.1
Host: <hostname>
Authorization: Bearer <authorization access token>
```

--------------------------------

### GET /api/v2/address/lt/postcodes/{postcodeId}/addresses - Get Addresses by Post Code

Source: https://www.post.lt/savitarna/api_doc.html

Gathers addresses associated with a specific post code ID. Supports searching by address string and pagination.

```APIDOC
## GET /api/v2/address/lt/postcodes/{postcodeId}/addresses

### Description
Gathers addresses associated with a specific post code ID. Supports searching by address string and pagination.

### Method
GET

### Endpoint
/api/v2/address/lt/postcodes/{postcodeId}/addresses

### Parameters
#### Path Parameters
- **postcodeId** (integer) - Required - Post code Id

#### Query Parameters
- **q** (string) - Optional - Address string to search for
- **skip** (integer) - Optional - Amount of addresses to skip
- **take** (integer) - Optional - Amount of addresses to return (default: 20)

### Response
#### Success Response (200)
- **data** (array) - List of addresses found.
- **skip** (integer) - The number of addresses skipped.
- **take** (integer) - The number of addresses returned.
- **total** (integer) - The total number of addresses available.

#### Response Example (200)
```json
{
  "data": [
    {
      "data": {
        "id": 103,
        "name": "Dariaus ir Girėno g. 7, 74119 Jurbarkas"
      },
      "type": "AddressInfo"
    }
  ],
  "skip": 0,
  "take": 20,
  "total": 1
}
```
```

--------------------------------

### Get SPD Stickers by Parcel IDs (GET /api/v2/sticker/spd/list)

Source: https://www.post.lt/savitarna/api_doc.html

Retrieves SPD stickers for initiated shipping items using their parcel IDs. This endpoint returns a list of shipping item labels.

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

--------------------------------

### POST /api/v2/shipping/initiate

Source: https://www.post.lt/savitarna/api_doc.html

Initiates the dispatch of parcels, returning identification numbers for shipping item carts.

```APIDOC
## POST /api/v2/shipping/initiate

### Description
To initiate dispatch of parcels. Returns identification numbers of shipping item carts.

### Method
POST

### Endpoint
/api/v2/shipping/initiate

### Parameters
#### Query Parameters
- **processAsync** (Boolean) - Optional - Default: true

#### Request Body
- **BaseItemListRequest** (Object) - Required - List of items to ship.

### Response
#### Success Response (200)
- **InitiateShippingResponse** - Shipping initiation confirmed.

#### Response Example
{
  "cartIds": ["cart_1", "cart_2"]
}
```

--------------------------------

### UNISEND (LP EXPRESS) API Overview

Source: https://www.post.lt/savitarna/api_doc.html

This section provides an overview of the UNISEND (LP EXPRESS) API, including its capabilities for address lookups and shipping management. It also details the available test and production environments and the importance of authentication.

```APIDOC
## UNISEND (LP EXPRESS) API Overview

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

### Environments
*   **Test Environment:** `https://api-manosiuntostst.post.lt`
*   **Production Environment:** `https://api-manosiuntos.post.lt`

### Authentication
All communication with the API must be authenticated. Only authenticated requests will be authorized. Refer to the **Authorization** page for detailed information about the security measures used.

### Key Functionalities
One of the most important functions of this API is to allow users to create, manage, and send an item by creating it, adding required documents, calling the courier, and tracking it. The processes for doing so are visualized below. You can also find all the needed API methods and data structures for creating a request for the API.

### Tools
*   **POSTMAN Requests Collection:** A base collection is provided to help with trying out the test environment of the API. Follow the instructions to import and use it for authorization and testing.
*   **Swagger:** An alternative way to test the API is by using the Swagger interface available on our side.
```

--------------------------------

### GET /api/v2/address/sender

Source: https://www.post.lt/savitarna/api_doc.html

Retrieves the default sender address.

```APIDOC
## GET /api/v2/address/sender

### Description
Retrieves the default sender address for the user.

### Method
GET

### Endpoint
/api/v2/address/sender

### Response
#### Success Response (200)
- **PersonResponse** - The default sender address.
```

--------------------------------

### POST /api/v2/tracking/configurations

Source: https://www.post.lt/savitarna/api_doc.html

Configures tracking event notifications by specifying preferred event types in the publishEvents array.

```APIDOC
## POST /api/v2/tracking/configurations

### Description
Used to modify personal tracking configuration. To configure which events to return, fill in the publishEvents array with preferred event types. If the array is set to null, all event types will be included in the /events GET response.

### Method
POST

### Endpoint
/api/v2/tracking/configurations

### Parameters
#### Request Body
- **publishEvents** (array) - Optional - List of event types to track. If null, all events are returned.

### Request Example
{
  "publishEvents": ["PARCEL_DELIVERED", "PARCEL_CANCELED"]
}

### Response
#### Success Response (200)
- **status** (string) - Confirmation of configuration update.

#### Response Example
{
  "status": "success"
}
```

--------------------------------

### GET /api/v2/parcel/{parcelId}

Source: https://www.post.lt/savitarna/api_doc.html

Retrieves details of a single parcel by its ID.

```APIDOC
## GET /api/v2/parcel/{parcelId}

### Description
To get details of a single parcel.

### Method
GET

### Endpoint
/api/v2/parcel/{parcelId}

### Parameters
#### Path Parameters
- **parcelId** (String) - Required - Unique identifier of the shipping item on “Mano siuntos” system.

### Response
#### Success Response (200)
- **ParcelBaseResponse** (Object) - Shipping item data structure.
```

--------------------------------

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

Source: https://www.post.lt/savitarna/api_doc.html

Retrieves a specific sender address by ID.

```APIDOC
## GET /api/v2/address/sender/{id}

### Description
Retrieves a sender address by its ID.

### Method
GET

### Endpoint
/api/v2/address/sender/{id}

### Parameters
#### Path Parameters
- **id** (string) - Required - The ID of the address.

### Response
#### Success Response (200)
- **PersonResponse** - The requested address.
```
Tokens:
Raw