Shipping label API

Shipping label API:
drop a shipment in, get a label out.

REST, JSON, one Bearer header. Signed webhooks instead of polling, real idempotency keys, errors that tell you what to fix. Ship to production for free.

Shipment GL-44819
Label ready
From
Austin, TX
To
London, GB
Service
FedEx International Priority
Weight
12.5 lbs
Charged to balance$33.40
Wallet: $312.60After: $279.20
Buy & printEdit
Every storefront. One inbox.

Built for social-first sellers.

Shopify, Etsy, WooCommerce, and TikTok Shop sync to To Ship — tracking pushes back when you print. Paste an Instagram or Facebook DM and AI builds the label.

S
Shopify
E-commerce
E
Etsy
Marketplace
W
WooCommerce
E-commerce
T
TikTok Shop
Social commerce
Via AI
I
Instagram
DM / screenshot
Via AI
F
Facebook
DM / screenshot
A
Amazon
Marketplace
e
eBay
Marketplace
How it works

First label from code.

POST /v1/shipments → rates[13] → POST /v1/labels → webhook: tracking.updated

01

Create an API key

Sign up, grab a key from the dashboard, and export it as an env var.

02

POST /v1/shipments

Send the to-address and parcel. Rates from 13 carriers come back in the response.

03

Buy and listen

Purchase the chosen rate, then let signed webhooks stream label and tracking events to you.

04

One tap, label in hand

Print from your phone or desktop straight to your thermal printer. Tracking syncs back to the store automatically. Refunds land in the wallet the same minute.

An API your team will like
Boring where it counts.

The boring-but-critical details, done properly.

One Bearer header

REST, JSON, one Bearer header. No SOAP, no XML, no OAuth dance for server-to-server.

Real idempotency keys

Send Idempotency-Key on writes and retries are safe. Duplicate labels don't happen by accident.

Errors that tell you what to fix

Validation failures come back as structured JSON pointing at the exact field, not a mystery 500.

Signed webhooks

Every webhook is signed so your handler can verify it came from GoatLabels before acting on it.

Wallet-based billing

Your integration spends from a prepaid balance you can top up by card, bank transfer, or crypto.

Free to build

Sign up to create an API key and ship to production on the Free plan — no card, no sales call.

Built for teams that ship code and parcels

The integration patterns GoatLabels was designed around.

Marketplace & platform startups

Rate shopping across the whole 13-carrier network is a single request — one endpoint instead of a carrier-by-carrier integration.

3PL integration teams

Signed webhooks push label and tracking events to your endpoint instead of you polling carriers for updates.

Subscription-box platforms

The API spends from a prepaid wallet you top up by card, bank transfer, or crypto — labels debit the balance, pay-per-label.

Ops teams next to the code

While your services call the API, your ops team can paste one-off orders to Billy — the GoatLabels AI assistant that drafts labels and removes retyping.

What customers are saying.

"We replaced a carrier-by-carrier integration mess with one endpoint. Rate shopping across the whole network is a single request now."
P
Platform engineer
marketplace startup
"Idempotency keys and signed webhooks out of the box meant our retry logic and event pipeline just worked on day one."
B
Backend dev
3PL integration team
"The wallet model maps cleanly to our accounting — the API spends a prepaid balance, no invoice reconciliation surprises."
C
CTO
subscription-box platform

Free to integrate. Pay when you print.

No card, no sales call to get a key.

Free

$0 forever

Everything you need to run your shop — genuinely free.

  • 50 shipments / month
  • Unlimited team, stores & public API
  • Billy AI assistant — chat, voice, memory, auto-buy
  • Fund with card or crypto
  • Shopify, Etsy, Woo, Amazon & TikTok into one To Ship queue
  • Standard all-in label pricing
Start free

Pro

$40/month

Everything in Free — plus unlimited shipments and Billy on Telegram.

  • Unlimited shipments — no monthly cap
  • Even cheaper rates on every label you buy
  • Billy AI on Telegram — run your shipping desk from anywhere
  • More off-web Billy channels coming (API, email, WhatsApp)
  • Often pays for itself once you ship enough
Go Pro

Questions, answered.

Straight answers about labels, payments, and pricing.

How do I authenticate?
REST, JSON, one Bearer header. Create an account, generate an API key in the dashboard, and send it as Authorization: Bearer on every request.
Which carriers can the API quote?
The full GoatLabels network: USPS, UPS, FedEx, and DHL, plus international partners including Royal Mail, Canada Post, Aramex, Asendia, ePost Global, Passport, and TNT.
Does the API support webhooks?
Yes — signed webhooks instead of polling. Subscribe your endpoint and receive label and tracking events, each signed so you can verify the source.
How are duplicate requests handled?
Send an Idempotency-Key header on writes. Retries with the same key return the original result instead of creating a second shipment or label.
What does the API cost?
You pay per label from a prepaid wallet — no monthly minimum on Free. Pro is a flat monthly plan with unlimited volume and cheaper label pricing. Check current pricing at goatlabels.io/pricing.
$ export GOAT_KEY=…

Your first label is one POST away

Sign up to create an API key. No card, no sales call.