REST JSON API · version 1

Book parcels straight from your own system

Your shop, warehouse, CRM or AI agent can quote a price, book a shipment and pull the label on its own. The API is free and the key is created in the account in a couple of minutes.

The API is free: you pay only for delivery at your usual rates
Set up in minutes: the key is issued instantly
Plain HTTP and JSON: any language, any platform

Start for free Developer documentation

For developers and AI agents

Four steps from zero to the first parcel

The whole path is below. If an AI agent does the integration, this page plus the documentation links at the end are enough.

Create an account

Sign-up is a link in an email, no password needed. API rates are exactly your account rates.

Create a key

The «API» item in the account header. The key is shown once, revoked in one click and travels in the Authorization: Bearer header.

Try the two calls

Price quotes work without a key, which makes them handy for checking your request. Booking already requires the key.

Read the documentation

Every field, error code and response example lives in the technical documentation and in the machine-readable OpenAPI spec.

Price quotes from every carrier

curl -G https://yousend.lv/api/production/v1/services/calculate \
  -d country_code=de \
  -d zip_code=10115 \
  -d package_type=1 \
  -d send_adr=0 \
  -d weight[]=2 \
  -d length[]=30 -d width[]=20 -d height[]=10

Booking a parcel

curl -X POST https://yousend.lv/api/production/v1/services/order-store \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: shop-order-1042' \
  -d '{"service_code":"dpd_classic","package_type":"1",
       "send_adr":"0","reason_for_export":"sold",
       "country_code":"de","zip_code":"10115",
       "recipient_name":"Anna Berg","recipient_city":"Berlin",
       "recipient_address_1":"Torstrasse 1",
       "recipient_phone":"4915112345678",
       "recipient_email":"anna@example.com",
       "parcel_description":"Books",
       "parcel_price":"25.00","parcel_currency":"0",
       "parcel_pickup_date":"2026-08-03 12:00:00",
       "parcel_pickup_address":"Lacplesa iela 87, Riga",
       "weight":["2"],"length":["30"],
       "width":["20"],"height":["10"]}'

Technical API documentation OpenAPI spec in JSON

Capabilities

What the API can already do

An honest list: only what works today.

Price quotes from every carrier

One request returns prices and transit times of every carrier available for that address and those dimensions. No key required.

Parcel booking

Sender, receiver, dimensions and goods go in a single request. The parcel shows up in the account as if booked by hand.

Shipment confirmation

A separate call hands the parcel over to the carrier and orders the pickup. That button used to exist only in the account.

PDF label by link

Once confirmed, the response carries a link to the label: print it from your system without logging in.

No duplicate parcels

The Idempotency-Key header: if the response is lost and the request is retried, you get the same parcel back instead of a second one.

List and details of your parcels

Statuses, tracking numbers and amounts for your shipments. A key only ever sees your own parcels.

Tracking-number webhook

As soon as the carrier issues a number we call your URL ourselves — no polling loop needed.

Platforms

Ready-made integrations

For WooCommerce there is a ready plugin — download it and install it yourself. For the other platforms write to us on WhatsApp: you talk to a human right away.

WooCommerce Ready

A free plugin for WordPress stores: the buyer sees courier rates at checkout, and you create the shipment and print the label straight from the order screen. No developer needed — installation takes a couple of minutes.

How to install Download the plugin

Mozello Coming soon

The integration for Mozello shops is already written and waits for approval from the platform itself. Write to us and we connect you first once it is published.

I want Mozello connected

Etsy

Shipping Etsy orders? Let us discuss how to link the shop to YouSend and pick a solution for your volume.

Request a connection

eBay

Selling on eBay? Tell us about your volume and marketplace and we will propose a setup.

Request a connection

Ready to automate your shipping?

Create a key and try the first request. If something does not add up, write to us and we will help.

Start for free Ask on WhatsApp