Quick security check

Verifying…

Protected by Cloudflare. This keeps bots from creating fake accounts.

We Ship YouAnythingAnywhere
  • Shop
  • Mobile APP
  • Docs
  • Pricing
  • About Us
  • Shop
    • WeShipYou

      Shop curated products from WeShipYou sellers, fulfilled end-to-end with our shipping guarantee.

    • Amazon

      Shop on Amazon, the world's largest store with the widest range of products, all with the security of WeShipYou!

    • eBay

      New and used items from US sellers: we buy Buy It Now listings for you.

    • AliExpress

      Millions of products at factory prices, bought and shipped by us.

    • Walmart

      Shop pharmacy and grocery products at Walmart quickly and easily!

    • Shein

      Shop the latest trending products at the best discounted prices, only at the Shein store!

    • Temu

      Shop the best products at discounted prices at the Temu store!

    • Shopify

      Search thousands of US Shopify stores at once, or paste a link from any of them.

  • Download Mobile APP
    • FulfillmentNew

      Receiving, storage, same-day pick & pack, multi-carrier shipping and returns — handled by us.

    • Price comparator

      Compare and select the shipping service based on your interest fast and easy

    • Shop integrations

      Shopify app, public API and more — plug WeShipYou into your store.

    • API

      API Access for developers

    • Invoicing

      Automatic monthly invoices, branded PDFs and one-click payments.

    • AI assistants

      Use ChatGPT, Claude, Gemini or Meta Muse with your WeShipYou account.

  • Docs
  • Pricing
  • About us
  • Recharges to Mexico
  • Recharges to Colombia
  • Overview
Guides
  • Quickstart
  • Authentication
  • Test mode and live mode
  • Shipments and labels
  • Tracking
  • Sub-accounts
  • Errors
  • AI assistants (MCP)
Authentication process
  • Authentication
General
  • Shipments
  • Tracking
  • Services
Forwarder
  • Forwarder
Mobile Recharges
  • Mobile Recharges
Account
  • Accounts
  • Account Addresses
  • Transactions
  • Add Funds
  • Add Sub Account
Download the OpenAPI spec
Menu
  • Overview
Guides
  • Quickstart
  • Authentication
  • Test mode and live mode
  • Shipments and labels
  • Tracking
  • Sub-accounts
  • Errors
  • AI assistants (MCP)
Authentication process
  • Authentication
General
  • Shipments
  • Tracking
  • Services
Forwarder
  • Forwarder
Mobile Recharges
  • Mobile Recharges
Account
  • Accounts
  • Account Addresses
  • Transactions
  • Add Funds
  • Add Sub Account
Download the OpenAPI spec

WeShipYou API

Version 1.1.0

The WeShipYou API is organized around REST. It has predictable, resource-oriented URLs, accepts JSON request bodies, returns JSON responses and uses standard HTTP status codes and verbs.

Test and live#

Try your integration against the Sandbox server (sandbox.weshipyou.com) first: nothing you do there reaches a real carrier or moves real money. The Live server (weshipyou.com) is real: labels bought there are charged to your wallet.

The API works on one object per request; there are no bulk updates.

OpenAPI#

This reference is generated from an OpenAPI 3.1 document. Download it from /docs/api/openapi.json and import it into Postman or any OpenAPI tool.

Cross-origin requests#

The API supports CORS for every origin, so you can call it from a browser. Never put an access token in code that other people can read.

Authentication#

The API authenticates every request with a JSON Web Token (JWT). There are no API keys.

  1. Call POST /authentication with your WeShipYou username (or email) and password. If two-factor authentication is on for your user, also send the current 6-digit code from your authenticator app as twoFactorToken.
  2. Send the accessToken you receive on every other request, in the header Authorization: Bearer <accessToken>.
  3. The token expires at exp (a Unix timestamp in the response). Log in again to get a new one.

A request without a valid token answers 401 NotAuthenticated. A request for an account you are not a member of answers 403 Forbidden or 404 NotFound.

JWT
HTTP bearer · JWT

The access token from POST /authentication (valid until its exp), sent as Authorization: Bearer <accessToken>.

Send it as Authorization: Bearer <token>

Guides

Quickstart

Get a token, create a shipment, buy its label and track it, all against the sandbox.

Authentication

Log in for a JSON Web Token, send it on every request, and keep it out of reach.

Test mode and live mode

Build against the sandbox, then switch one address and one token to go live.

Shipments and labels

Quote, create, update and buy a label for a shipment, and cancel it before pickup.

Tracking

Read the status and checkpoints of a shipment, and confirm a delivery.

Sub-accounts

Create sub-accounts, list them under their parent, and ship for one of them.

Errors

The shape of an error, what each status means, and when to retry.

AI assistants (MCP)

Connect Claude, ChatGPT, Cursor, VS Code, a chat bot or an assistant you build to your WeShipYou account over MCP and OAuth.

Servers

  • https://weshipyou.com/api/v1Live
  • https://sandbox.weshipyou.com/api/v1Sandbox

Errors

WeShipYou answers with conventional HTTP status codes: 2xx means the request worked, 4xx means the request was wrong (a missing field, a bad token, a shipment in a state that does not allow the change), 5xx means something failed on our side. Every error body has the same shape: name, message, code (the HTTP status), className and, for validation errors, data with the fields that failed.

400
Bad request: a field is missing or has the wrong value. The message says which.
401
No access token, or the token is invalid or expired. Authenticate again.
403
The token is valid but cannot act on this account or resource.
404
Nothing with that id exists in your accounts.
409
The resource changed state: for example, the shipment already has a label.
429
Too many requests. Wait a moment and retry.
5xx
Something failed on our side. Retry later; contact support if it persists.
Error body
1
2
3
4
5
6
7
{
  "name": "NotAuthenticated",
  "message": "Missing or invalid access token",
  "code": 401,
  "className": "not-authenticated",
  "data": {}
}

Resources

Authentication
  • POST/authentication
Shipments
  • POST/shipments/rates
  • GET/shipments
  • POST/shipments
  • GET/shipments/{shipmentId}
  • PATCH/shipments/{shipmentId}
  • DELETE/shipments/{shipmentId}
  • GET/shipments/categories
  • GET/shipments/country-categories
  • POST/shipments/labels
  • DELETE/shipments/labels/{trackingNumber}
  • POST/shipments/confirm-delivery
Tracking
  • GET/tracking/{trackingNumber}
Services
  • GET/services
Forwarder
  • GET/forwarder
  • GET/forwarder/{forwardingOrderId}
Mobile Recharges
  • GET/mobile-recharges/providers
  • GET/mobile-recharges/providers-descriptions
  • GET/mobile-recharges/products-descriptions
  • GET/mobile-recharges/recharges
  • POST/mobile-recharges/recharges
Accounts
  • GET/accounts
  • GET/accounts/{accountId}
  • PATCH/accounts/{accountId}
Account Addresses
  • GET/account-addresses
  • POST/account-addresses
  • PATCH/account-addresses/{accountAddressId}
Transactions
  • GET/transactions
  • GET/transactions/{transactionId}
Add Funds
  • POST/add-funds
Add Sub Account
  • POST/add-sub-account

Join our newsletter!

No spam, guaranteed.

Miami, FL — United States Warehouse

1940 NW 70th Ave, Miami, FL 33126

Get Directions
Follow us
GroupChannel
RechargesRecharge to MexicoRecharge to ColombiaRecharge to JamaicaRecharge to Nicaragua
ShippingSend a packageFulfillment serviceShop integrationsInvoicingAI assistantsShip to ColombiaShip to BrazilShip to MexicoLocker for Colombia
ResourcesDownload APPApiCommercial Assistance
CompanyAbout
Careers
Hiring
Become an AffiliateSupportContact us
Shop
WeShipYou
Amazon
eBay
AliExpress
Walmart
Shein
Temu
Shopify

WeShipYou is proud to be PCI-compliant certified, ensuring the highest standards of payment security and data protection

© We Ship You Corp. Terms of service · Privacy Policy · Legal

The WeShipYou logo and the name "WeShipYou" are registered trademarks of We Ship You Corp

Theme
WeShipYou