Sign In

Api ReferenceVersion: 0.0.1

Download OpenAPI specification:

The WeShipYou API is organized around REST. Our API has predictable resource-oriented URLs, accepts form-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

Introduction

You can use the WeShipYou API in test mode, which doesn't affect your live data or interact with the banking networks. The API key you use to authenticate the request determines whether the request is live mode or test mode.

The WeShipYou API doesn't support bulk updates. You can work on only one object per request.

The WeShipYou API differs for every account as we release new versions and tailor functionality. Log in to see docs customized to your version of the API, with your test key and data.

OpenAPI Specification

This API is documented in OpenAPI format.
In addition to standard
OpenAPI syntax we use a few internal modifications to illustrated the documentation better, you can download and test in your postman or other OpenApi compatible software, also you can test right here all in live.

Cross-Origin Resource Sharing

This API features Cross-Origin Resource Sharing (CORS) implemented in compliance with W3C spec.
And that allows cross-domain communication from the browser.
All responses have a wildcard same-origin which makes them completely public and accessible to everyone, including any code on any site.

Authentication

This topic describes the different forms of authentication that are available in the WeShipYou API, and how to use them.

WeShipYou offers four forms of authentication: secret key, publishable key, JSON Web Tokens, and public signature key.

  • Secret API key: Use to make requests from the server side. Never share these keys. Keep them guarded and secure.
  • Publishable API key: Use in your client-side code to tokenize payment information.
  • JWT: Use to make short-life tokens that expire after a set period of time.

Authentication

Get an API Access Token

WeShipYou uses Bearer Authentication to authenticate requests. You will need to include Authorization: Bearer <API Access Token> in the header for all requests.

Before you get started, you will need to generate an API Access Token on our dashboard.

header Parameters
Accept-Language
string
Default: en-US
Example: en-US

The language you prefer for messages. Supported values are en-AU, en-CA, en-GB, en-US, es-ES, es-US, pt-BR pt-PT

Request Body schema:
application/json

Pet object that needs to be added to the store

username
string
Default: "{{username}}"

Username registered with WeShipYou

password
string
Default: "{{password}}"

Your password

Responses

Request samples

Code samples

application/json
{
  • "username": "{{username}}",
  • "password": "{{password}}"
}

Response samples

application/json
{
  • "accessToken": "string",
  • "iat": 0,
  • "exp": 0,
  • "user": {
    }
}

Shipments

Everything about your shipments

Calculate shipping rates

Authorizations:
JWTSecretApiKey
header Parameters
Accept-Language
string
Default: en-US
Example: en-US

The language you prefer for messages. Supported values are en-AU, en-CA, en-GB, en-US, es-ES, es-US, pt-BR pt-PT

Request Body schema:
application/json

Shipment object that needs to be added to your account

required
string or string
totalValue
required
number <= 2999
insurance
boolean
incoterms
required
string
Enum: "DDU" "DDP"
required
object (RatesAddress)
required
object (RatesAddress)
required
Array of objects (parcels) [ 1 .. 100 ] items

Responses

Request samples

Code samples

application/json
{
  • "accountId": "string",
  • "totalValue": 2999,
  • "insurance": true,
  • "incoterms": "DDU",
  • "sender": {
    },
  • "recipient": {
    },
  • "parcels": [
    ]
}

Add a new shipment to your account

Add new shipment to your account inventory.

Authorizations:
JWTSecretApiKey
header Parameters
Accept-Language
string
Default: en-US
Example: en-US

The language you prefer for messages. Supported values are en-AU, en-CA, en-GB, en-US, es-ES, es-US, pt-BR pt-PT

Request Body schema:
application/json

Shipment object that needs to be added to your account

required
string or string
required
object (sender)
required
object (recipient)
totalValue
required
number <= 2999
externalReferenceCode
string
externalCustomerId
string
insurance
boolean
incoterms
required
string
Enum: "DDU" "DDP"
required
Array of objects (parcels) [ 1 .. 100 ] items

Responses

Request samples

Code samples

application/json
{
  • "accountId": "string",
  • "sender": {
    },
  • "recipient": {
    },
  • "totalValue": 2999,
  • "externalReferenceCode": "string",
  • "externalCustomerId": "string",
  • "insurance": true,
  • "incoterms": "DDU",
  • "parcels": [
    ]
}

Find shipments

Lookup shipments to your account inventory.

Authorizations:
JWTSecretApiKey
header Parameters
Accept-Language
string
Default: en-US
Example: en-US

The language you prefer for messages. Supported values are en-AU, en-CA, en-GB, en-US, es-ES, es-US, pt-BR pt-PT

Responses

Request samples


Get shipment info

Get shipment shipment to your account inventory.

Authorizations:
JWTSecretApiKey
path Parameters
shipmentId
required
string

ID of shipment

header Parameters
Accept-Language
string
Default: en-US
Example: en-US

The language you prefer for messages. Supported values are en-AU, en-CA, en-GB, en-US, es-ES, es-US, pt-BR pt-PT

Responses

Request samples


Update an existing shipment

Authorizations:
JWTSecretApiKey
path Parameters
shipmentId
required
string

ID of shipment

header Parameters
Accept-Language
string
Default: en-US
Example: en-US

The language you prefer for messages. Supported values are en-AU, en-CA, en-GB, en-US, es-ES, es-US, pt-BR pt-PT

Request Body schema:
application/json

Shipment object that needs to be added to your account

required
string or string
required
object (sender)
required
object (recipient)
totalValue
required
number <= 2999
externalReferenceCode
string
externalCustomerId
string
insurance
boolean
incoterms
required
string
Enum: "DDU" "DDP"
required
Array of objects (parcels) [ 1 .. 100 ] items

Responses

Request samples

Code samples

application/json
{
  • "accountId": "string",
  • "sender": {
    },
  • "recipient": {
    },
  • "totalValue": 2999,
  • "externalReferenceCode": "string",
  • "externalCustomerId": "string",
  • "insurance": true,
  • "incoterms": "DDU",
  • "parcels": [
    ]
}

Delete / Cancel a shipment

Delete and cancel shipment when possible, shipments that are already handled by the carrier can not be canceled or refunded

Authorizations:
JWTSecretApiKey
path Parameters
shipmentId
required
string

Pet id to delete

header Parameters
Accept-Language
string
Default: en-US
Example: en-US

The language you prefer for messages. Supported values are en-AU, en-CA, en-GB, en-US, es-ES, es-US, pt-BR pt-PT

x-api-key
string
Example: Bearer <TOKEN>

Responses

Request samples


Get shipment categories

Get shipment categories.

Authorizations:
JWTSecretApiKey
header Parameters
Accept-Language
string
Default: en-US
Example: en-US

The language you prefer for messages. Supported values are en-AU, en-CA, en-GB, en-US, es-ES, es-US, pt-BR pt-PT

Responses

Request samples


Get country categories

Get specific country categories for customs purposes

Authorizations:
JWTSecretApiKey
header Parameters
Accept-Language
string
Default: en-US
Example: en-US

The language you prefer for messages. Supported values are en-AU, en-CA, en-GB, en-US, es-ES, es-US, pt-BR pt-PT

Responses

Request samples


Services

WeShipYou Services

Find services

Find services available in WeShipYou.com

Authorizations:
JWTSecretApiKey
query Parameters
$limit
number [ 0 .. 500 ]
Default: 20

Limit a number of results

header Parameters
Accept-Language
string
Default: en-US
Example: en-US

The language you prefer for messages. Supported values are en-AU, en-CA, en-GB, en-US, es-ES, es-US, pt-BR pt-PT

Responses

Request samples


Forwarder

WeShipYou Forwarder Ooders

Find Forwarder Orders

Find Forwarder Orders Available in WeShipYou.com

Authorizations:
JWTSecretApiKey
query Parameters
$limit
number [ 0 .. 500 ]
Default: 20

Limit a number of results

header Parameters
Accept-Language
string
Default: en-US
Example: en-US

The language you prefer for messages. Supported values are en-AU, en-CA, en-GB, en-US, es-ES, es-US, pt-BR pt-PT

Responses

Request samples

Response samples

application/json
{
  • "total": 0,
  • "limit": 0,
  • "skip": 0,
  • "data": [
    ]
}

Mobile Recharges

WeShipYou FoMobile Recharges

Find Mobile Recharge Providers

Find Mobile Recharge Providers in WeShipYou.com

Authorizations:
JWTSecretApiKey
query Parameters
$limit
number [ 0 .. 500 ]
Default: 20

Limit a number of results

header Parameters
Accept-Language
string
Default: en-US
Example: en-US

The language you prefer for messages. Supported values are en-AU, en-CA, en-GB, en-US, es-ES, es-US, pt-BR pt-PT

Responses

Request samples

Response samples

application/json
{
  • "total": 0,
  • "limit": 0,
  • "skip": 0,
  • "data": [
    ]
}

Find Mobile Recharge Providers Descriptions

Find Mobile Recharge Providers Descriptions in WeShipYou.com

Authorizations:
JWTSecretApiKey
query Parameters
$limit
number [ 0 .. 500 ]
Default: 20

Limit a number of results

header Parameters
Accept-Language
string
Default: en-US
Example: en-US

The language you prefer for messages. Supported values are en-AU, en-CA, en-GB, en-US, es-ES, es-US, pt-BR pt-PT

Responses

Request samples

Response samples

application/json
{
  • "total": 0,
  • "limit": 0,
  • "skip": 0,
  • "data": [
    ]
}

Find Mobile Recharge Products Descriptions

Find Mobile Recharge Products Descriptions in WeShipYou.com

Authorizations:
JWTSecretApiKey
query Parameters
$limit
number [ 0 .. 500 ]
Default: 20

Limit a number of results

header Parameters
Accept-Language
string
Default: en-US
Example: en-US

The language you prefer for messages. Supported values are en-AU, en-CA, en-GB, en-US, es-ES, es-US, pt-BR pt-PT

Responses

Request samples

Response samples

application/json
{
  • "total": 0,
  • "limit": 0,
  • "skip": 0,
  • "data": [
    ]
}

Find Mobile Recharges

Find Mobile Recharges in WeShipYou.com

Authorizations:
JWTSecretApiKey
query Parameters
$limit
number [ 0 .. 500 ]
Default: 20

Limit a number of results

header Parameters
Accept-Language
string
Default: en-US
Example: en-US

The language you prefer for messages. Supported values are en-AU, en-CA, en-GB, en-US, es-ES, es-US, pt-BR pt-PT

Responses

Request samples

Response samples

application/json
{
  • "total": 0,
  • "limit": 0,
  • "skip": 0,
  • "data": [
    ]
}

Create Mobile Recharges

Create Mobile Recharges in WeShipYou.com

Authorizations:
JWTSecretApiKey
query Parameters
$limit
number [ 0 .. 500 ]
Default: 20

Limit a number of results

header Parameters
Accept-Language
string
Default: en-US
Example: en-US

The language you prefer for messages. Supported values are en-AU, en-CA, en-GB, en-US, es-ES, es-US, pt-BR pt-PT

Request Body schema:
application/json

Shipment object that needs to be added to your account

paymentMethod
string

The payment method to be used

accountUid
string

The accountUid to be used, if you only have one, we will detect automatically

object
scheduleDate
date or null
amount
number
object

Responses

Request samples

Code samples

application/json
{
  • "paymentMethod": "zelle",
  • "accountUid": "string",
  • "rechargeable_product": {
    },
  • "scheduleDate": null,
  • "amount": 0,
  • "account_rechargeable_contact": {
    }
}

Response samples

application/json
{
  • "total": 0,
  • "limit": 0,
  • "skip": 0,
  • "data": [
    ]
}

Add Funds

Add funds to your account

Add money to ypu account.

Authorizations:
JWTSecretApiKey
header Parameters
Accept-Language
string
Default: en-US
Example: en-US

The language you prefer for messages. Supported values are en-AU, en-CA, en-GB, en-US, es-ES, es-US, pt-BR pt-PT

Request Body schema:
application/json

Shipment object that needs to be added to your account

paymentMethod
string
Default: "zelle"

The payment method to be used

accountUid
string

The accountUid to be used, if you only have one, we will detect automatically

object

Responses

Request samples

Code samples

application/json
{
  • "paymentMethod": "zelle",
  • "accountUid": "string",
  • "transaction": {
    }
}

Response samples

application/json
{
  • "result": true,
  • "transaction": {
    },
  • "transactionFee": {
    }
}

Add Sub Account

Add new customer to your account

Add new customer to your account with his own forwarding address.

Authorizations:
JWTSecretApiKey
header Parameters
Accept-Language
string
Default: en-US
Example: en-US

The language you prefer for messages. Supported values are en-AU, en-CA, en-GB, en-US, es-ES, es-US, pt-BR pt-PT

Request Body schema:
application/json

Shipment object that needs to be added to your account

accountUid
string

The accountUid to be used, if you only have one, we will detect automatically

externalAccountNumber
string
name
required
string non-empty
displayName
required
string non-empty
systemUnits
required
string
Enum: "imperial" "metric"
email
required
string non-empty
notificationEmail
required
string non-empty
website
required
string
phone
required
string non-empty
emergencyPhone
required
string non-empty
taxId
string
object or null
uid
string
accountNumber
string
status
string
language
required
string
isBusiness
required
boolean
allowBankAccountPayments
boolean
metadata
object
createdAt
date
updatedAt
date
deletedAt
date
addressId
number
billingAddressId
number
defaultShipFromId
number
defaultAddressOnLabelId
number
defaultReturnAddressId
number
primaryPaymentShipmentsId
number
logoId
number
pickupServiceFallbackId
number
revision
number
object (AccountAddress)

Responses

Request samples

Code samples

application/json
{
  • "accountUid": "string",
  • "externalAccountNumber": "string",
  • "name": "string",
  • "displayName": "string",
  • "systemUnits": "imperial",
  • "email": "string",
  • "notificationEmail": "string",
  • "website": "string",
  • "phone": "string",
  • "emergencyPhone": "string",
  • "taxId": "string",
  • "taxIdCountry": {
    },
  • "uid": "string",
  • "accountNumber": "string",
  • "status": "string",
  • "language": "string",
  • "isBusiness": true,
  • "allowBankAccountPayments": true,
  • "metadata": { },
  • "createdAt": null,
  • "updatedAt": null,
  • "deletedAt": null,
  • "addressId": 0,
  • "billingAddressId": 0,
  • "defaultShipFromId": 0,
  • "defaultAddressOnLabelId": 0,
  • "defaultReturnAddressId": 0,
  • "primaryPaymentShipmentsId": 0,
  • "logoId": 0,
  • "pickupServiceFallbackId": 0,
  • "revision": 0,
  • "address": {
    }
}

Response samples

application/json
{
  • "name": "string",
  • "displayName": "string",
  • "systemUnits": "imperial",
  • "email": "string",
  • "notificationEmail": "string",
  • "website": "string",
  • "phone": "string",
  • "emergencyPhone": "string",
  • "taxId": "string",
  • "taxIdCountry": {
    },
  • "uid": "string",
  • "accountNumber": "string",
  • "status": "string",
  • "language": "string",
  • "isBusiness": true,
  • "allowBankAccountPayments": true,
  • "metadata": { },
  • "createdAt": null,
  • "updatedAt": null,
  • "deletedAt": null,
  • "addressId": 0,
  • "billingAddressId": 0,
  • "defaultShipFromId": 0,
  • "defaultAddressOnLabelId": 0,
  • "defaultReturnAddressId": 0,
  • "primaryPaymentShipmentsId": 0,
  • "logoId": 0,
  • "pickupServiceFallbackId": 0,
  • "revision": 0,
  • "address": {
    }
}

whatsapp-avatar
WeShipYouTypically replies within 5 minutes