Quick security check

Check the box so we know it’s really you.

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.

  • Docs
  • Pricing
  • About us
  • Recharges to Mexico
  • Recharges to Colombia

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 integrationsInvoicingShip 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
  • Overview
Authentication process
  • Authentication
General
  • Shipments
  • Tracking
  • Services
Forwarder
  • Forwarder
    • The Forwarding order object
    • GETList forwarding orders
    • GETGet a forwarding order
Mobile Recharges
  • Mobile Recharges
Account
  • Accounts
  • Account Addresses
  • Transactions
  • Add Funds
  • Add Sub Account
Download the OpenAPI spec
Menu
  • Overview
Authentication process
  • Authentication
General
  • Shipments
  • Tracking
  • Services
Forwarder
  • Forwarder
    • The Forwarding order object
    • GETList forwarding orders
    • GETGet a forwarding order
Mobile Recharges
  • Mobile Recharges
Account
  • Accounts
  • Account Addresses
  • Transactions
  • Add Funds
  • Add Sub Account
Download the OpenAPI spec

Forwarder

Your forwarding orders

  • GET/forwarder
  • GET/forwarder/{forwardingOrderId}

The Forwarding order object

Attributes

  • uidstring
  • wsyOrderNumberstring
  • externalReferenceCodestringnullable
  • totalPricenumbernullable
  • totalItemsnumber
  • sellerNotesstringnullable
  • buyerNotesstringnullable
  • personalShopperServiceboolean | integer
  • createdAtstring <date-time>
  • updatedAtstring <date-time>
  • destinationCountryIdintegernullable

    Id of the destination country (see GET /shipments/country-categories).

  • forwarding_order_itemsarray of object
    Child attributes
    • uidstring
    • orderNumberstringnullable
    • skustringnullable
    • descriptionstring
    • statusstring
    • urlstringnullable
    • qtynumber
    • pricenumbernullable
    • shippingCostnumber
    • trackingNumberstringnullable
    • handlingCostnumber
    • weightnumber
    • colorstringnullable
    • sizestringnullable
    • alternativeColorstringnullable
    • alternativeSizestringnullable
    • observationsstringnullable
    • imageUrlstringnullable
    • createdAtstring <date-time>
    • updatedAtstring <date-time>
    • currencyobject
    • originCountryobject
    • categoryCategory

      A shipment content category. Each parcel item declares one.

      Child attributes
      • uidstringrequired

        Category UID.

      • namestringrequired

        Display name.

      • slugstringrequired

        Stable machine name.

      • weightnumbernullable

        Default weight for one unit, in grams.

      • lengthnumbernullable

        Default length, in centimeters.

      • widthnumbernullable

        Default width, in centimeters.

      • heightnumbernullable

        Default height, in centimeters.

      • containsDocumentsboolean | integer

        Items in this category are documents. 1/true or 0/false.

      • containsOtherDgboolean | integer

        Items in this category are dangerous goods other than batteries. 1/true or 0/false.

      • containsLiquidsboolean | integer

        Items in this category contain liquids. 1/true or 0/false.

      • containsBatteryPi967boolean | integer

        Lithium-ion batteries contained in equipment (PI 967). 1/true or 0/false.

      • containsBatteryPi966boolean | integer

        Lithium-ion batteries packed with equipment (PI 966). 1/true or 0/false.

      • containsBatteryPi965boolean | integer

        Lithium-ion batteries on their own (PI 965). 1/true or 0/false.

      • parentIdintegernullable

        Parent category, when this is a sub-category.

    • country_categoryCountry category
      Child attributes
      • uidstringnullable
      • namestringnullable
      • slugstringnullable
      • weightnumbernullable
      • lengthnumbernullable
      • widthnumbernullable
      • heightnumbernullable
      • containsDocumentsbooleannullable
      • containsOtherDgbooleannullable
      • containsLiquidsbooleannullable
      • containsBatteryPi967booleannullable
      • containsBatteryPi966booleannullable
      • containsBatteryPi965booleannullable
      • customsValuenumbernullable
      • qtynumbernullable
      • maxWeightnumbernullable
      • unitTypestringnullable
      • observationsstringnullable
      • isDiscontinuedbooleannullable
      • createdAtstring <date-time>nullable
      • updatedAtstring <date-time>nullable
      • parentIdnumbernullable
The Forwarding order object
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
{
  "uid": "0prh3ei97u7b",
  "wsyOrderNumber": "FOXVIY5BFCPW",
  "externalReferenceCode": null,
  "totalPrice": null,
  "totalItems": 0,
  "sellerNotes": null,
  "buyerNotes": null,
  "personalShopperService": 0,
  "createdAt": "2026-11-01T00:37:53.000Z",
  "updatedAt": "2026-11-01T00:37:53.000Z",
  "destinationCountryId": null,
  "forwarding_order_items": [
    {
      "uid": "ltinx3lzbjxv",
      "orderNumber": null,
      "sku": null,
      "description": "locker item1xo",
      "status": "arrived_to_warehouse",
      "url": null,
      "qty": 1,
      "price": null,
      "shippingCost": 0,
      "trackingNumber": null,
      "handlingCost": 1,
      "weight": 1000,
      "color": null,
      "size": null,
      "alternativeColor": null,
      "alternativeSize": null,
      "observations": null,
      "imageUrl": null,
      "createdAt": "2026-11-01T00:37:53.000Z",
      "updatedAt": "2026-11-01T00:37:53.000Z",
      "currency": {},
      "originCountry": {},
      "category": {
        "uid": "u40h56jccmdi",
        "name": "Phone Accessory (no battery)",
        "slug": "accessory_no_battery",
        "weight": null,
        "length": null,
        "width": null,
        "height": null,
        "containsDocuments": 0,
        "containsOtherDg": 0,
        "containsLiquids": 0,
        "containsBatteryPi967": 0,
        "containsBatteryPi966": 0,
        "containsBatteryPi965": 0,
        "parentId": null
      },
      "country_category": {
        "uid": null,
        "name": null,
        "slug": null,
        "weight": null,
        "length": null,
        "width": null,
        "height": null,
        "containsDocuments": null,
        "containsOtherDg": null,
        "containsLiquids": null,
        "containsBatteryPi967": null,
        "containsBatteryPi966": null,
        "containsBatteryPi965": null,
        "customsValue": null,
        "qty": null,
        "maxWeight": null,
        "unitType": null,
        "observations": null,
        "isDiscontinued": null,
        "createdAt": null,
        "updatedAt": null,
        "parentId": null
      }
    }
  ]
}

List forwarding orders

GET/forwarder
Requires an access token

Lists the forwarding orders of your accounts, with their items.

Query parameters

  • accountIdstring

    Limit the results to one of your accounts: its uid, its account number (CU…) or its external account number. Without it, all the accounts you belong to are included.

  • $limitnumber

    Maximum number of results (default 20).

    Default: 20
    >= 0 · <= 500
  • $skipnumber

    Number of results to skip, for paging.

    Default: 0
    >= 0

Header parameters

  • Accept-Languagestring

    Two-letter code of the language for messages: en, es or pt.

    Default: en-US

Responses

200

Successful operation

  • totalnumber
  • limitnumber
  • skipnumber
  • dataarray of Forwarding order
    The Forwarding order object
401

Missing or invalid access token

  • namestring
    Always NotAuthenticated
  • messagestring
  • codenumber
    Always 401
  • classNamestring
    Always not-authenticated
  • dataobject
GET/forwarder
1
2
curl 'https://sandbox.weshipyou.com/api/v1/forwarder' \
  -H "Authorization: Bearer $WSY_ACCESS_TOKEN"
Response
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
{
  "total": 1,
  "limit": 20,
  "skip": 0,
  "data": [
    {
      "uid": "0prh3ei97u7b",
      "wsyOrderNumber": "FOXVIY5BFCPW",
      "externalReferenceCode": null,
      "totalPrice": null,
      "totalItems": 0,
      "sellerNotes": null,
      "buyerNotes": null,
      "personalShopperService": 0,
      "createdAt": "2026-11-01T00:37:53.000Z",
      "updatedAt": "2026-11-01T00:37:53.000Z",
      "destinationCountryId": null,
      "forwarding_order_items": [
        {
          "uid": "ltinx3lzbjxv",
          "orderNumber": null,
          "sku": null,
          "description": "locker item1xo",
          "status": "arrived_to_warehouse",
          "url": null,
          "qty": 1,
          "price": null,
          "shippingCost": 0,
          "trackingNumber": null,
          "handlingCost": 1,
          "weight": 1000,
          "color": null,
          "size": null,
          "alternativeColor": null,
          "alternativeSize": null,
          "observations": null,
          "imageUrl": null,
          "createdAt": "2026-11-01T00:37:53.000Z",
          "updatedAt": "2026-11-01T00:37:53.000Z",
          "currency": {},
          "originCountry": {},
          "category": {
            "uid": "u40h56jccmdi",
            "name": "Phone Accessory (no battery)",
            "slug": "accessory_no_battery",
            "weight": null,
            "length": null,
            "width": null,
            "height": null,
            "containsDocuments": 0,
            "containsOtherDg": 0,
            "containsLiquids": 0,
            "containsBatteryPi967": 0,
            "containsBatteryPi966": 0,
            "containsBatteryPi965": 0,
            "parentId": null
          },
          "country_category": {
            "uid": null,
            "name": null,
            "slug": null,
            "weight": null,
            "length": null,
            "width": null,
            "height": null,
            "containsDocuments": null,
            "containsOtherDg": null,
            "containsLiquids": null,
            "containsBatteryPi967": null,
            "containsBatteryPi966": null,
            "containsBatteryPi965": null,
            "customsValue": null,
            "qty": null,
            "maxWeight": null,
            "unitType": null,
            "observations": null,
            "isDiscontinued": null,
            "createdAt": null,
            "updatedAt": null,
            "parentId": null
          }
        }
      ]
    }
  ]
}
Try itSend a real request to Test from this page. No code needed.

Get a forwarding order

GET/forwarder/{forwardingOrderId}
Requires an access token

Returns one of your forwarding orders with its items.

Path parameters

  • forwardingOrderIdstringrequired

    The forwarding order uid.

Header parameters

  • Accept-Languagestring

    Two-letter code of the language for messages: en, es or pt.

    Default: en-US

Responses

200

The forwarding order

The Forwarding order object
401

Missing or invalid access token

  • namestring
    Always NotAuthenticated
  • messagestring
  • codenumber
    Always 401
  • classNamestring
    Always not-authenticated
  • dataobject
404

No shipment has that id

  • namestring
    Always NotFound
  • messagestring
  • codenumber
    Always 404
  • classNamestring
    Always not-found
  • dataobject
GET/forwarder/{forwardingOrderId}
1
2
curl 'https://sandbox.weshipyou.com/api/v1/forwarder/{forwardingOrderId}' \
  -H "Authorization: Bearer $WSY_ACCESS_TOKEN"
Response
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
{
  "uid": "0prh3ei97u7b",
  "wsyOrderNumber": "FOXVIY5BFCPW",
  "externalReferenceCode": null,
  "totalPrice": null,
  "totalItems": 0,
  "sellerNotes": null,
  "buyerNotes": null,
  "personalShopperService": 0,
  "createdAt": "2026-11-01T00:37:53.000Z",
  "updatedAt": "2026-11-01T00:37:53.000Z",
  "destinationCountryId": null,
  "forwarding_order_items": [
    {
      "uid": "ltinx3lzbjxv",
      "orderNumber": null,
      "sku": null,
      "description": "locker item1xo",
      "status": "arrived_to_warehouse",
      "url": null,
      "qty": 1,
      "price": null,
      "shippingCost": 0,
      "trackingNumber": null,
      "handlingCost": 1,
      "weight": 1000,
      "color": null,
      "size": null,
      "alternativeColor": null,
      "alternativeSize": null,
      "observations": null,
      "imageUrl": null,
      "createdAt": "2026-11-01T00:37:53.000Z",
      "updatedAt": "2026-11-01T00:37:53.000Z",
      "currency": {},
      "originCountry": {},
      "category": {
        "uid": "u40h56jccmdi",
        "name": "Phone Accessory (no battery)",
        "slug": "accessory_no_battery",
        "weight": null,
        "length": null,
        "width": null,
        "height": null,
        "containsDocuments": 0,
        "containsOtherDg": 0,
        "containsLiquids": 0,
        "containsBatteryPi967": 0,
        "containsBatteryPi966": 0,
        "containsBatteryPi965": 0,
        "parentId": null
      },
      "country_category": {
        "uid": null,
        "name": null,
        "slug": null,
        "weight": null,
        "length": null,
        "width": null,
        "height": null,
        "containsDocuments": null,
        "containsOtherDg": null,
        "containsLiquids": null,
        "containsBatteryPi967": null,
        "containsBatteryPi966": null,
        "containsBatteryPi965": null,
        "customsValue": null,
        "qty": null,
        "maxWeight": null,
        "unitType": null,
        "observations": null,
        "isDiscontinued": null,
        "createdAt": null,
        "updatedAt": null,
        "parentId": null
      }
    }
  ]
}
Try itSend a real request to Test from this page. No code needed.