Sender.lv Starting Guide

Getting Started

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

  • Create account on https://new.sender.lv
  • Go to Integrations / API section in your account, add a new integration.
  • In the form, enter the integration name, select the integration type, provide the callback URL of your shop, set a secret code for establishing the connection, and choose the warehouse address (the default address from which your shipments will be fulfilled).
  • Connect your Sender.lv sandbox to dev.shipmentapi.com here in Account -> My Sandboxes (right top corner menu). Use sandbox key only.
  • 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.
  • Send parcels with sender.lv API.


How to create an account on Sender.lv ?

Please visit https://new.sender.lv/en/client/login, click on Register, and 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.


How to get sandbox API KEY ?

Once you have set up your account at https://new.sender.lv, you can proceed getting your API Test KEY.

While logged into new.sender.lv, navigate to your account and click on Integrations / API section, add a new integration. 

In the new integration form, enter the integration name, select the integration type, provide the callback URL of your shop, set a secret code for establishing the connection with your system, and choose the warehouse address (the default address from which your shipments will be fulfilled).

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 test sender API Live ?

Once you have set up your account at https://new.sender.lv, and got your API Test KEY you can  Connect your Sender.lv test account here in Account -> My Sandboxes (right top corner menu).

Click Add Sanbox
 button and specify:

  • Title - This is your internal name for the sandbox, allowing you to differentiate between multiple sandboxes in the future if necessary
  • X-Api-key - This is the API key you have obtained from sender.lv.
  • Default - Indicate whether this is currently your primary sandbox for testing. You have the ability to add several Sandboxes and toggle between them.

After, procced to API Reference section:

  • On the left menu select a section and read the documentation.
  • Press the PLAY button in each section to send predefined API requests and view live responses from our  server.

P.S. Test API requests won't create actual orders but are designed to simulate real orders, allowing you to experience the system's functionality. 


How to authenticate API requests?

Before you can begin interacting with Sender API, you first need to create a Sender.lv account and request API KEY from our team.

  • Once you obtained sandbox/production API key,  include x-api-key header 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'


How to get production API KEY ?

Once you have completed your testing, you can proceed and get your LIVE API KEY.

While logged into https://new.sender.lv, navigate to Integrations / API section, select you desired integration and get your PRIMARY API KEY there. 

Need a little help ?

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