list F.A.Q.

help_circle Support

API Documentation

Automate your shipments using our Shippment API


Sender.lv offers a comprehensive suite of APIs designed to streamline and optimize shipping and logistics processes. These APIs enable businesses to manage shipments efficiently by providing access to a variety of services and shipping features.

Key functionalities include:

  • Get Available Countries / Destinations: Retrieve a list of countries where Sender.lv offers shipping services, ensuring coverage and availability for international shipments.
  • Get Rates & Delivery Options: Obtain shipping rates and delivery options for specific destinations, allowing businesses to compare and select the best options for their needs.
  • Order: Address -> Address: Create and manage orders for shipments from one physical address to another, ideal for standard door-to-door deliveries.
  • Order: Address -> Parcel Locker: Facilitate shipments from a physical address to a parcel locker, providing convenient delivery options for recipients.
  • Order: Parcel Locker -> Address: Enable shipments from a parcel locker to a physical address, adding flexibility in delivery and pickup locations.
  • Order: Between Parcel Lockers: Arrange shipments between parcel lockers, offering a secure and convenient method for package transfers.
  • Get Order by Reference: Retrieve detailed information about a specific order using its reference number, ensuring easy tracking and management.
  • Get Orders List: Access a list of all orders, allowing for comprehensive tracking and oversight of shipping activities.

These APIs provide businesses with robust tools to manage their logistics operations efficiently, ensuring smooth and reliable shipping experiences for their customers.

Some other great features include:

  • Retrieve Available Pick-Up Dates and Times for Each Carrier: No more guessing—simply select the most suitable pickup time option from the provided list.
  • Get Closest Parcel Lockers for Each Address: The API automatically identifies the top 10 closest parcel lockers for a destination, eliminating the need to manually search or overwhelm clients with a full list.
  • Get Shipping Labels via Callback URL: Once your order is processed, shipping labels are sent directly to your callback URL. This highly requested feature helps avoid long server response times and eliminates the need for manual/repetitive requests to get updates.


Developer Portal / Documentation: https://dev.shipmentapi.com/en



Getting Started with Sender API


Before you can begin interacting with Sender API, you first need to create a Sender.lv account. 

  • Create an account on our shipping portal https://new.sender.lv
  • Complete the registration process using your email and phone number. You have the option to register as either a private or business client by filling out the form.
  • Send us the email address you used for registration - we will activate your account for API access.
  • Once activated, you will be able to test your API credentials and start testing the integration.


Create a Default Sender Address

After registration and authentication, go to: My Account → Address Book

Create a default sender address for your warehouse, office, or online shop. This address will be used as the default pickup location for courier collections and as the default return address for undelivered parcels.

Although the API allows you to specify different sender addresses  for individual shipments, creating a default sender address is required before you can start using the API.


Creating an API Integration

Go to: My Account → Settings → Integrations / API

There you can create a new API integration and get the API credentials required for connecting to the Sender.lv API.

Fill in the integration form:

  • Name– name for this integration (e.g. your shop or application name).
  • Type– Select Custom API Integration.
  • URL– The full URL of your website or application (including https://).
  • Statuses URL (optional) – Your webhook endpoint that will receive shipment status updates.
  • X-Senderise-Api-Code – A secret key generated by your application. It is used to verify requests between your system and Sender.lv.
  • Warehouse Address– Select your default sender address from the Address Book (created in previous step).

Click Save to create the integration. The API credentials will then be generated and displayed for use in your application.



API Documentation and Testing

The complete API documentation is available at: https://dev.shipmentapi.com

  • Register on our Developer Portal: https://dev.shipmentapi.com/en/client/register
  • On Developer portal connect your Sender.lv sandbox:  Account -> My Sandboxes (right top corner menu).
  • Use only your Sandbox API Key while developing and testing your integration.
  • Test API requests live and learn various API scenarious here in one place: API Reference.
  • After completing the sandbox tests, use the Production API key.


What are the API Client requirments ?

Sender.lv takes your and your customer's security seriously. Therefore, before interacting with our API, please check if your client supports the protocols and security features we require.

  • HTTPS(TLS)
  • Certificate. Our certificate is signed by Google Trust Services. Most operating systems and clients have built-in support for automatically verifying these certificates. In case yours doesn't, you can add the Google Trust Root Certificate to your list of trusted Certificate Authorities (CA). Please note that our API's server certificate is rotated regularly and it is therefore not recommended to pin our certificate instead.
  • HTTP version. The Sender API supports both HTTP/1.1 and HTTP/2. HTTP/3 is not (yet) supported. HTTP/1.0 is not supported.
  • GET requests that include a body. The Sender API does not support GET requests that include a body, you will get 403 (Forbidden).
  • IP Version. Currently our API is only available using IPv4.

Do you have API rate limits?

To ensure fair usage, prevent system overloading, and protect API resources, our API has default rate limits that limit the number of requests that can be made within a specific time frame. Rate limits are specified in the following format:

  • Safe requests (GET): 60 requests per minute.  
  • If there are more than 60 requests, a 1-minute ban will be imposed.

Please request change rate limits if you require more.


How to authenticate API requests?

  • Once you obtained sandbox/production API key,  include x-api-keyheader value.
  • Here's an example using curl to authenticate a request to the Sender API:

curl --location 'https://api.sender.lv/api/sandbox/v1/orders' \

--header 'Accept: application/json' \
--header 'x-api-key: 239uw87yhuih87sdf'



Need a little help ?

We're here to support you with any questions you might have about our APIs, or otherwise.