Postmen API docs for S.F. ISP

Labels

Labels

POST Create a label

Try it 
/labels

Create a label

NameTypeDescription
service_type * string Service Types Accepts: sf-express-isp_america_direct_ship,sf-express-isp_cloud_warehouse_next_day_delivery,sf-express-isp_cloud_warehouse_third_day_delivery,sf-express-isp_ecommerce_economy_express,sf-express-isp_ecommerce_express,sf-express-isp_ecommerce_special_delivery,sf-express-isp_economy_express,sf-express-isp_international_ecommerce_special_delivery,sf-express-isp_international_economy_express_document,sf-express-isp_international_economy_express_merchant_agent,sf-express-isp_international_economy_express_parcel,sf-express-isp_international_economy_express_pilot,sf-express-isp_international_heavy_freight,sf-express-isp_international_small_parcel,sf-express-isp_international_standard_express_document,sf-express-isp_international_standard_express_parcel,sf-express-isp_next_morning_delivery,sf-express-isp_register_mail,sf-express-isp_same_day_delivery,sf-express-isp_standard_express.
shipper_account * reference Object reference
shipment * shipment An instance of shipping freight or cargo
async boolean enable async mode or not (set to false if not provided)
return_shipment boolean (set to false if not provided)
paper_size string Label Paper Size Accepts: default. (set to "default" if not provided)
file_type string Label file type Accepts: pdf. (set to "pdf" if not provided)
ship_date string Ship Date in YYYY-MM-DD, if not provided, will be today of the shipper account timezone
service_options array of service option - insurance or service option - pickup Service options
is_document boolean If the shipment is document type. (set to false if not provided)
invoice invoice Invoice object, used to describe invoice type. Optional. Commercial invoice will be generated if field is present in the request body, else not.
references array of strings Reference numbers for a label
billing billing Billing Object
customs customs Customs Object
order_number string A user-defined order number used to identify an order.
order_id string Unique identification of the order.

	{
	  "async": false,
	  "return_shipment": false,
	  "paper_size": "default",
	  "service_type": "sf-express-isp_standard_express",
	  "is_document": false,
	  "service_options": [
	    {
	      "type": "insurance",
	      "insured_value": {
	        "amount": 10,
	        "currency": "CNY"
	      }
	    }
	  ],
	  "invoice": {
	    "date": "2019-10-11"
	  },
	  "references": [
	    "13N11ME-MP"
	  ],
	  "shipper_account": {
	    "id": "00000000-0000-0000-0000-000000000000"
	  },
	  "customs": {
	    "billing": {
	      "paid_by": "recipient",
	      "method": {
	        "type": "account",
	        "account_number": "AA00888AAAABBBB"
	      }
	    },
	    "terms_of_trade": "ddu",
	    "purpose": "merchandise"
	  },
	  "billing": {
	    "paid_by": "shipper"
	  },
	  "shipment": {
	    "ship_from": {
	      "contact_name": "美瑞克斯旗舰店",
	      "phone": "400-990-1503",
	      "company_name": "aftership(深圳)",
	      "street1": "郑州市经济开发区经北二路第九大街东500",
	      "city": "郑州市",
	      "email": "panda@aftership.com",
	      "state": "河南省",
	      "postal_code": "450000",
	      "country": "CHN",
	      "type": "business"
	    },
	    "ship_to": {
	      "contact_name": "Panda",
	      "company_name": "Panda(TWN.Company)",
	      "phone": "+886-48331889-1238",
	      "email": "Panda@test.com",
	      "state": "广东省",
	      "street1": "深圳市粤兴三道112号",
	      "city": "深圳市",
	      "postal_code": "518000",
	      "country": "CHN",
	      "type": "residential"
	    },
	    "parcels": [
	      {
	        "description": "iMac (Retina 5K, 27-inch, Late 2014)",
	        "box_type": "custom",
	        "weight": {
	          "value": 9.84,
	          "unit": "kg"
	        },
	        "dimension": {
	          "width": 65,
	          "height": 52,
	          "depth": 21,
	          "unit": "cm"
	        },
	        "items": [
	          {
	            "description": "iMac (Retina 5K, 27-inch, Late 2017)",
	            "origin_country": "USA",
	            "quantity": 1,
	            "price": {
	              "amount": 1999,
	              "currency": "CNY"
	            },
	            "weight": {
	              "value": 9.54,
	              "unit": "kg"
	            },
	            "sku": "imac2014"
	          },
	          {
	            "description": "Google Nexus 10",
	            "origin_country": "USA",
	            "quantity": 1,
	            "sku": "google man",
	            "price": {
	              "amount": 550,
	              "currency": "CNY"
	            },
	            "weight": {
	              "value": 0.3,
	              "unit": "kg"
	            }
	          }
	        ]
	      },
	      {
	        "box_type": "custom",
	        "weight": {
	          "unit": "kg",
	          "value": 1.2
	        },
	        "dimension": {
	          "depth": 15,
	          "width": 10,
	          "height": 1,
	          "unit": "in"
	        },
	        "items": [
	          {
	            "description": "Samsung Galaxy Tab wifi 3G 64GB black",
	            "origin_country": "USA",
	            "quantity": 2,
	            "price": {
	              "amount": 50,
	              "currency": "CNY"
	            },
	            "weight": {
	              "value": 0.6,
	              "unit": "kg"
	            },
	            "sku": "Epic_Food_Bar",
	            "hs_code": "215155"
	          }
	        ]
	      },
	      {
	        "box_type": "custom",
	        "weight": {
	          "unit": "kg",
	          "value": 1.6
	        },
	        "dimension": {
	          "depth": 5,
	          "width": 4,
	          "height": 3,
	          "unit": "cm"
	        },
	        "items": [
	          {
	            "description": "Samsung Galaxy Tab wifi 3G 64GB white",
	            "origin_country": "HKG",
	            "quantity": 2,
	            "price": {
	              "amount": 40,
	              "currency": "CNY"
	            },
	            "weight": {
	              "value": 0.4,
	              "unit": "kg"
	            },
	            "hs_code": "23528222"
	          },
	          {
	            "description": "Inches Quad-Core 3G Tablet PC With 1GB RAM, 16GB ROM Silver",
	            "origin_country": "HKG",
	            "quantity": 2,
	            "price": {
	              "amount": 40,
	              "currency": "CNY"
	            },
	            "weight": {
	              "value": 0.4,
	              "unit": "kg"
	            },
	            "hs_code": "23528222"
	          }
	        ]
	      }
	    ]
	  }
	}
	

	curl --request POST \
	    --url https://sandbox-api.postmen.com/v3/labels \
	    --header 'content-type: application/json' \
	    --header 'postmen-api-key: 8fc7966b-679b-4a57-911d-c5a663229c9e' \
	    --data '{"async":false,"return_shipment":false,"paper_size":"default","service_type":"sf-express-isp_standard_express","is_document":false,"service_options":[{"type":"insurance","insured_value":{"amount":10,"currency":"CNY"}}],"invoice":{"date":"2019-10-11"},"references":["13N11ME-MP"],"shipper_account":{"id":"00000000-0000-0000-0000-000000000000"},"customs":{"billing":{"paid_by":"recipient","method":{"type":"account","account_number":"AA00888AAAABBBB"}},"terms_of_trade":"ddu","purpose":"merchandise"},"billing":{"paid_by":"shipper"},"shipment":{"ship_from":{"contact_name":"美瑞克斯旗舰店","phone":"400-990-1503","company_name":"aftership(深圳)","street1":"郑州市经济开发区经北二路第九大街东500","city":"郑州市","email":"panda@aftership.com","state":"河南省","postal_code":"450000","country":"CHN","type":"business"},"ship_to":{"contact_name":"Panda","company_name":"Panda(TWN.Company)","phone":"+886-48331889-1238","email":"Panda@test.com","state":"广东省","street1":"深圳市粤兴三道112号","city":"深圳市","postal_code":"518000","country":"CHN","type":"residential"},"parcels":[{"description":"iMac (Retina 5K, 27-inch, Late 2014)","box_type":"custom","weight":{"value":9.84,"unit":"kg"},"dimension":{"width":65,"height":52,"depth":21,"unit":"cm"},"items":[{"description":"iMac (Retina 5K, 27-inch, Late 2017)","origin_country":"USA","quantity":1,"price":{"amount":1999,"currency":"CNY"},"weight":{"value":9.54,"unit":"kg"},"sku":"imac2014"},{"description":"Google Nexus 10","origin_country":"USA","quantity":1,"sku":"google man","price":{"amount":550,"currency":"CNY"},"weight":{"value":0.3,"unit":"kg"}}]},{"box_type":"custom","weight":{"unit":"kg","value":1.2},"dimension":{"depth":15,"width":10,"height":1,"unit":"in"},"items":[{"description":"Samsung Galaxy Tab wifi 3G 64GB black","origin_country":"USA","quantity":2,"price":{"amount":50,"currency":"CNY"},"weight":{"value":0.6,"unit":"kg"},"sku":"Epic_Food_Bar","hs_code":"215155"}]},{"box_type":"custom","weight":{"unit":"kg","value":1.6},"dimension":{"depth":5,"width":4,"height":3,"unit":"cm"},"items":[{"description":"Samsung Galaxy Tab wifi 3G 64GB white","origin_country":"HKG","quantity":2,"price":{"amount":40,"currency":"CNY"},"weight":{"value":0.4,"unit":"kg"},"hs_code":"23528222"},{"description":"Inches Quad-Core 3G Tablet PC With 1GB RAM, 16GB ROM Silver","origin_country":"HKG","quantity":2,"price":{"amount":40,"currency":"CNY"},"weight":{"value":0.4,"unit":"kg"},"hs_code":"23528222"}]}]}}'
	

	using System;
	using System.Net;
	using System.IO;
	
	class ExamplePostmen
	{
	    static void Main(string[] args)
		{
	        WebRequest httpWebRequest = WebRequest.Create("https://sandbox-api.postmen.com/v3/labels");
	        string json = "{\"async\":false,\"return_shipment\":false,\"paper_size\":\"default\",\"service_type\":\"sf-express-isp_standard_express\",\"is_document\":false,\"service_options\":[{\"type\":\"insurance\",\"insured_value\":{\"amount\":10,\"currency\":\"CNY\"}}],\"invoice\":{\"date\":\"2019-10-11\"},\"references\":[\"13N11ME-MP\"],\"shipper_account\":{\"id\":\"00000000-0000-0000-0000-000000000000\"},\"customs\":{\"billing\":{\"paid_by\":\"recipient\",\"method\":{\"type\":\"account\",\"account_number\":\"AA00888AAAABBBB\"}},\"terms_of_trade\":\"ddu\",\"purpose\":\"merchandise\"},\"billing\":{\"paid_by\":\"shipper\"},\"shipment\":{\"ship_from\":{\"contact_name\":\"美瑞克斯旗舰店\",\"phone\":\"400-990-1503\",\"company_name\":\"aftership(深圳)\",\"street1\":\"郑州市经济开发区经北二路第九大街东500\",\"city\":\"郑州市\",\"email\":\"panda@aftership.com\",\"state\":\"河南省\",\"postal_code\":\"450000\",\"country\":\"CHN\",\"type\":\"business\"},\"ship_to\":{\"contact_name\":\"Panda\",\"company_name\":\"Panda(TWN.Company)\",\"phone\":\"+886-48331889-1238\",\"email\":\"Panda@test.com\",\"state\":\"广东省\",\"street1\":\"深圳市粤兴三道112号\",\"city\":\"深圳市\",\"postal_code\":\"518000\",\"country\":\"CHN\",\"type\":\"residential\"},\"parcels\":[{\"description\":\"iMac (Retina 5K, 27-inch, Late 2014)\",\"box_type\":\"custom\",\"weight\":{\"value\":9.84,\"unit\":\"kg\"},\"dimension\":{\"width\":65,\"height\":52,\"depth\":21,\"unit\":\"cm\"},\"items\":[{\"description\":\"iMac (Retina 5K, 27-inch, Late 2017)\",\"origin_country\":\"USA\",\"quantity\":1,\"price\":{\"amount\":1999,\"currency\":\"CNY\"},\"weight\":{\"value\":9.54,\"unit\":\"kg\"},\"sku\":\"imac2014\"},{\"description\":\"Google Nexus 10\",\"origin_country\":\"USA\",\"quantity\":1,\"sku\":\"google man\",\"price\":{\"amount\":550,\"currency\":\"CNY\"},\"weight\":{\"value\":0.3,\"unit\":\"kg\"}}]},{\"box_type\":\"custom\",\"weight\":{\"unit\":\"kg\",\"value\":1.2},\"dimension\":{\"depth\":15,\"width\":10,\"height\":1,\"unit\":\"in\"},\"items\":[{\"description\":\"Samsung Galaxy Tab wifi 3G 64GB black\",\"origin_country\":\"USA\",\"quantity\":2,\"price\":{\"amount\":50,\"currency\":\"CNY\"},\"weight\":{\"value\":0.6,\"unit\":\"kg\"},\"sku\":\"Epic_Food_Bar\",\"hs_code\":\"215155\"}]},{\"box_type\":\"custom\",\"weight\":{\"unit\":\"kg\",\"value\":1.6},\"dimension\":{\"depth\":5,\"width\":4,\"height\":3,\"unit\":\"cm\"},\"items\":[{\"description\":\"Samsung Galaxy Tab wifi 3G 64GB white\",\"origin_country\":\"HKG\",\"quantity\":2,\"price\":{\"amount\":40,\"currency\":\"CNY\"},\"weight\":{\"value\":0.4,\"unit\":\"kg\"},\"hs_code\":\"23528222\"},{\"description\":\"Inches Quad-Core 3G Tablet PC With 1GB RAM, 16GB ROM Silver\",\"origin_country\":\"HKG\",\"quantity\":2,\"price\":{\"amount\":40,\"currency\":\"CNY\"},\"weight\":{\"value\":0.4,\"unit\":\"kg\"},\"hs_code\":\"23528222\"}]}]}}";
	
	        httpWebRequest.ContentType = "application/json";
	        httpWebRequest.Method = "POST";
	        httpWebRequest.Headers["postmen-api-key"] = "8fc7966b-679b-4a57-911d-c5a663229c9e";
	
	        using (StreamWriter streamWriter = new StreamWriter(httpWebRequest.GetRequestStream()))
	        {
	            streamWriter.Write(json);
	            streamWriter.Flush();
	            streamWriter.Close();
	        }
	
	        HttpWebResponse httpResponse = (HttpWebResponse)httpWebRequest.GetResponse();
	        using (StreamReader streamReader = new StreamReader(httpResponse.GetResponseStream()))
	        {
	            string result = streamReader.ReadToEnd();
	            Console.WriteLine(result);
	        }
	    }
	}
	

	import com.squareup.okhttp.*;
	
	public class test {
	
	    public static void main(String[] args) {
		    OkHttpClient client = new OkHttpClient();
	
	    	MediaType mediaType = MediaType.parse("application/json");
	        RequestBody body = RequestBody.create(mediaType, "{\"async\":false,\"return_shipment\":false,\"paper_size\":\"default\",\"service_type\":\"sf-express-isp_standard_express\",\"is_document\":false,\"service_options\":[{\"type\":\"insurance\",\"insured_value\":{\"amount\":10,\"currency\":\"CNY\"}}],\"invoice\":{\"date\":\"2019-10-11\"},\"references\":[\"13N11ME-MP\"],\"shipper_account\":{\"id\":\"00000000-0000-0000-0000-000000000000\"},\"customs\":{\"billing\":{\"paid_by\":\"recipient\",\"method\":{\"type\":\"account\",\"account_number\":\"AA00888AAAABBBB\"}},\"terms_of_trade\":\"ddu\",\"purpose\":\"merchandise\"},\"billing\":{\"paid_by\":\"shipper\"},\"shipment\":{\"ship_from\":{\"contact_name\":\"美瑞克斯旗舰店\",\"phone\":\"400-990-1503\",\"company_name\":\"aftership(深圳)\",\"street1\":\"郑州市经济开发区经北二路第九大街东500\",\"city\":\"郑州市\",\"email\":\"panda@aftership.com\",\"state\":\"河南省\",\"postal_code\":\"450000\",\"country\":\"CHN\",\"type\":\"business\"},\"ship_to\":{\"contact_name\":\"Panda\",\"company_name\":\"Panda(TWN.Company)\",\"phone\":\"+886-48331889-1238\",\"email\":\"Panda@test.com\",\"state\":\"广东省\",\"street1\":\"深圳市粤兴三道112号\",\"city\":\"深圳市\",\"postal_code\":\"518000\",\"country\":\"CHN\",\"type\":\"residential\"},\"parcels\":[{\"description\":\"iMac (Retina 5K, 27-inch, Late 2014)\",\"box_type\":\"custom\",\"weight\":{\"value\":9.84,\"unit\":\"kg\"},\"dimension\":{\"width\":65,\"height\":52,\"depth\":21,\"unit\":\"cm\"},\"items\":[{\"description\":\"iMac (Retina 5K, 27-inch, Late 2017)\",\"origin_country\":\"USA\",\"quantity\":1,\"price\":{\"amount\":1999,\"currency\":\"CNY\"},\"weight\":{\"value\":9.54,\"unit\":\"kg\"},\"sku\":\"imac2014\"},{\"description\":\"Google Nexus 10\",\"origin_country\":\"USA\",\"quantity\":1,\"sku\":\"google man\",\"price\":{\"amount\":550,\"currency\":\"CNY\"},\"weight\":{\"value\":0.3,\"unit\":\"kg\"}}]},{\"box_type\":\"custom\",\"weight\":{\"unit\":\"kg\",\"value\":1.2},\"dimension\":{\"depth\":15,\"width\":10,\"height\":1,\"unit\":\"in\"},\"items\":[{\"description\":\"Samsung Galaxy Tab wifi 3G 64GB black\",\"origin_country\":\"USA\",\"quantity\":2,\"price\":{\"amount\":50,\"currency\":\"CNY\"},\"weight\":{\"value\":0.6,\"unit\":\"kg\"},\"sku\":\"Epic_Food_Bar\",\"hs_code\":\"215155\"}]},{\"box_type\":\"custom\",\"weight\":{\"unit\":\"kg\",\"value\":1.6},\"dimension\":{\"depth\":5,\"width\":4,\"height\":3,\"unit\":\"cm\"},\"items\":[{\"description\":\"Samsung Galaxy Tab wifi 3G 64GB white\",\"origin_country\":\"HKG\",\"quantity\":2,\"price\":{\"amount\":40,\"currency\":\"CNY\"},\"weight\":{\"value\":0.4,\"unit\":\"kg\"},\"hs_code\":\"23528222\"},{\"description\":\"Inches Quad-Core 3G Tablet PC With 1GB RAM, 16GB ROM Silver\",\"origin_country\":\"HKG\",\"quantity\":2,\"price\":{\"amount\":40,\"currency\":\"CNY\"},\"weight\":{\"value\":0.4,\"unit\":\"kg\"},\"hs_code\":\"23528222\"}]}]}}");
	
	    	Request request = new Request.Builder()
	    		.url("https://sandbox-api.postmen.com/v3/labels")
	            .post(body)
	    		.addHeader("postmen-api-key", "8fc7966b-679b-4a57-911d-c5a663229c9e")
	    		.addHeader("content-type", "application/json")
	    		.build();
	
	    	try {
	    		Response response = client.newCall(request).execute();
	    		System.out.println(response.body().string());
	    	} catch (Exception e) {
	    		System.err.println("Caught IOException: " + e.getMessage());
	    	}
	    }
	}
	
var request = require("request");
	var options = {
		method: 'POST',
	    url: 'https://sandbox-api.postmen.com/v3/labels',
	    headers: {
			'content-type': 'application/json',
	        'postmen-api-key': '8fc7966b-679b-4a57-911d-c5a663229c9e'
		},
	    body: '{"async":false,"return_shipment":false,"paper_size":"default","service_type":"sf-express-isp_standard_express","is_document":false,"service_options":[{"type":"insurance","insured_value":{"amount":10,"currency":"CNY"}}],"invoice":{"date":"2019-10-11"},"references":["13N11ME-MP"],"shipper_account":{"id":"00000000-0000-0000-0000-000000000000"},"customs":{"billing":{"paid_by":"recipient","method":{"type":"account","account_number":"AA00888AAAABBBB"}},"terms_of_trade":"ddu","purpose":"merchandise"},"billing":{"paid_by":"shipper"},"shipment":{"ship_from":{"contact_name":"美瑞克斯旗舰店","phone":"400-990-1503","company_name":"aftership(深圳)","street1":"郑州市经济开发区经北二路第九大街东500","city":"郑州市","email":"panda@aftership.com","state":"河南省","postal_code":"450000","country":"CHN","type":"business"},"ship_to":{"contact_name":"Panda","company_name":"Panda(TWN.Company)","phone":"+886-48331889-1238","email":"Panda@test.com","state":"广东省","street1":"深圳市粤兴三道112号","city":"深圳市","postal_code":"518000","country":"CHN","type":"residential"},"parcels":[{"description":"iMac (Retina 5K, 27-inch, Late 2014)","box_type":"custom","weight":{"value":9.84,"unit":"kg"},"dimension":{"width":65,"height":52,"depth":21,"unit":"cm"},"items":[{"description":"iMac (Retina 5K, 27-inch, Late 2017)","origin_country":"USA","quantity":1,"price":{"amount":1999,"currency":"CNY"},"weight":{"value":9.54,"unit":"kg"},"sku":"imac2014"},{"description":"Google Nexus 10","origin_country":"USA","quantity":1,"sku":"google man","price":{"amount":550,"currency":"CNY"},"weight":{"value":0.3,"unit":"kg"}}]},{"box_type":"custom","weight":{"unit":"kg","value":1.2},"dimension":{"depth":15,"width":10,"height":1,"unit":"in"},"items":[{"description":"Samsung Galaxy Tab wifi 3G 64GB black","origin_country":"USA","quantity":2,"price":{"amount":50,"currency":"CNY"},"weight":{"value":0.6,"unit":"kg"},"sku":"Epic_Food_Bar","hs_code":"215155"}]},{"box_type":"custom","weight":{"unit":"kg","value":1.6},"dimension":{"depth":5,"width":4,"height":3,"unit":"cm"},"items":[{"description":"Samsung Galaxy Tab wifi 3G 64GB white","origin_country":"HKG","quantity":2,"price":{"amount":40,"currency":"CNY"},"weight":{"value":0.4,"unit":"kg"},"hs_code":"23528222"},{"description":"Inches Quad-Core 3G Tablet PC With 1GB RAM, 16GB ROM Silver","origin_country":"HKG","quantity":2,"price":{"amount":40,"currency":"CNY"},"weight":{"value":0.4,"unit":"kg"},"hs_code":"23528222"}]}]}}'
	};
	
	request(options, function (error, response, body) {
	    if (error) throw new Error(error);
	    console.log(body);
	});

	<?php
	
	    $url = 'https://sandbox-api.postmen.com/v3/labels';
	    $method = 'POST';
	    $headers = array(
	        "content-type: application/json",
	        "postmen-api-key: 8fc7966b-679b-4a57-911d-c5a663229c9e"
	    );
	    $body = '{"async":false,"return_shipment":false,"paper_size":"default","service_type":"sf-express-isp_standard_express","is_document":false,"service_options":[{"type":"insurance","insured_value":{"amount":10,"currency":"CNY"}}],"invoice":{"date":"2019-10-11"},"references":["13N11ME-MP"],"shipper_account":{"id":"00000000-0000-0000-0000-000000000000"},"customs":{"billing":{"paid_by":"recipient","method":{"type":"account","account_number":"AA00888AAAABBBB"}},"terms_of_trade":"ddu","purpose":"merchandise"},"billing":{"paid_by":"shipper"},"shipment":{"ship_from":{"contact_name":"美瑞克斯旗舰店","phone":"400-990-1503","company_name":"aftership(深圳)","street1":"郑州市经济开发区经北二路第九大街东500","city":"郑州市","email":"panda@aftership.com","state":"河南省","postal_code":"450000","country":"CHN","type":"business"},"ship_to":{"contact_name":"Panda","company_name":"Panda(TWN.Company)","phone":"+886-48331889-1238","email":"Panda@test.com","state":"广东省","street1":"深圳市粤兴三道112号","city":"深圳市","postal_code":"518000","country":"CHN","type":"residential"},"parcels":[{"description":"iMac (Retina 5K, 27-inch, Late 2014)","box_type":"custom","weight":{"value":9.84,"unit":"kg"},"dimension":{"width":65,"height":52,"depth":21,"unit":"cm"},"items":[{"description":"iMac (Retina 5K, 27-inch, Late 2017)","origin_country":"USA","quantity":1,"price":{"amount":1999,"currency":"CNY"},"weight":{"value":9.54,"unit":"kg"},"sku":"imac2014"},{"description":"Google Nexus 10","origin_country":"USA","quantity":1,"sku":"google man","price":{"amount":550,"currency":"CNY"},"weight":{"value":0.3,"unit":"kg"}}]},{"box_type":"custom","weight":{"unit":"kg","value":1.2},"dimension":{"depth":15,"width":10,"height":1,"unit":"in"},"items":[{"description":"Samsung Galaxy Tab wifi 3G 64GB black","origin_country":"USA","quantity":2,"price":{"amount":50,"currency":"CNY"},"weight":{"value":0.6,"unit":"kg"},"sku":"Epic_Food_Bar","hs_code":"215155"}]},{"box_type":"custom","weight":{"unit":"kg","value":1.6},"dimension":{"depth":5,"width":4,"height":3,"unit":"cm"},"items":[{"description":"Samsung Galaxy Tab wifi 3G 64GB white","origin_country":"HKG","quantity":2,"price":{"amount":40,"currency":"CNY"},"weight":{"value":0.4,"unit":"kg"},"hs_code":"23528222"},{"description":"Inches Quad-Core 3G Tablet PC With 1GB RAM, 16GB ROM Silver","origin_country":"HKG","quantity":2,"price":{"amount":40,"currency":"CNY"},"weight":{"value":0.4,"unit":"kg"},"hs_code":"23528222"}]}]}}';
	
	    $curl = curl_init();
	
	    curl_setopt_array($curl, array(
	        CURLOPT_RETURNTRANSFER => true,
	        CURLOPT_URL => $url,
	        CURLOPT_CUSTOMREQUEST => $method,
	        CURLOPT_HTTPHEADER => $headers,
			CURLOPT_POSTFIELDS => $body
	    ));
	
	    $response = curl_exec($curl);
	    $err = curl_error($curl);
	
	    curl_close($curl);
	
	    if ($err) {
	    	echo "cURL Error #:" . $err;
	    } else {
	    	echo $response;
	    }
	?>
	

	# Make sure to install requests: pip install requests
	import requests
	
	url = 'https://sandbox-api.postmen.com/v3/labels'
	
	payload = '''
	{
	  "async": false,
	  "return_shipment": false,
	  "paper_size": "default",
	  "service_type": "sf-express-isp_standard_express",
	  "is_document": false,
	  "service_options": [
	    {
	      "type": "insurance",
	      "insured_value": {
	        "amount": 10,
	        "currency": "CNY"
	      }
	    }
	  ],
	  "invoice": {
	    "date": "2019-10-11"
	  },
	  "references": [
	    "13N11ME-MP"
	  ],
	  "shipper_account": {
	    "id": "00000000-0000-0000-0000-000000000000"
	  },
	  "customs": {
	    "billing": {
	      "paid_by": "recipient",
	      "method": {
	        "type": "account",
	        "account_number": "AA00888AAAABBBB"
	      }
	    },
	    "terms_of_trade": "ddu",
	    "purpose": "merchandise"
	  },
	  "billing": {
	    "paid_by": "shipper"
	  },
	  "shipment": {
	    "ship_from": {
	      "contact_name": "美瑞克斯旗舰店",
	      "phone": "400-990-1503",
	      "company_name": "aftership(深圳)",
	      "street1": "郑州市经济开发区经北二路第九大街东500",
	      "city": "郑州市",
	      "email": "panda@aftership.com",
	      "state": "河南省",
	      "postal_code": "450000",
	      "country": "CHN",
	      "type": "business"
	    },
	    "ship_to": {
	      "contact_name": "Panda",
	      "company_name": "Panda(TWN.Company)",
	      "phone": "+886-48331889-1238",
	      "email": "Panda@test.com",
	      "state": "广东省",
	      "street1": "深圳市粤兴三道112号",
	      "city": "深圳市",
	      "postal_code": "518000",
	      "country": "CHN",
	      "type": "residential"
	    },
	    "parcels": [
	      {
	        "description": "iMac (Retina 5K, 27-inch, Late 2014)",
	        "box_type": "custom",
	        "weight": {
	          "value": 9.84,
	          "unit": "kg"
	        },
	        "dimension": {
	          "width": 65,
	          "height": 52,
	          "depth": 21,
	          "unit": "cm"
	        },
	        "items": [
	          {
	            "description": "iMac (Retina 5K, 27-inch, Late 2017)",
	            "origin_country": "USA",
	            "quantity": 1,
	            "price": {
	              "amount": 1999,
	              "currency": "CNY"
	            },
	            "weight": {
	              "value": 9.54,
	              "unit": "kg"
	            },
	            "sku": "imac2014"
	          },
	          {
	            "description": "Google Nexus 10",
	            "origin_country": "USA",
	            "quantity": 1,
	            "sku": "google man",
	            "price": {
	              "amount": 550,
	              "currency": "CNY"
	            },
	            "weight": {
	              "value": 0.3,
	              "unit": "kg"
	            }
	          }
	        ]
	      },
	      {
	        "box_type": "custom",
	        "weight": {
	          "unit": "kg",
	          "value": 1.2
	        },
	        "dimension": {
	          "depth": 15,
	          "width": 10,
	          "height": 1,
	          "unit": "in"
	        },
	        "items": [
	          {
	            "description": "Samsung Galaxy Tab wifi 3G 64GB black",
	            "origin_country": "USA",
	            "quantity": 2,
	            "price": {
	              "amount": 50,
	              "currency": "CNY"
	            },
	            "weight": {
	              "value": 0.6,
	              "unit": "kg"
	            },
	            "sku": "Epic_Food_Bar",
	            "hs_code": "215155"
	          }
	        ]
	      },
	      {
	        "box_type": "custom",
	        "weight": {
	          "unit": "kg",
	          "value": 1.6
	        },
	        "dimension": {
	          "depth": 5,
	          "width": 4,
	          "height": 3,
	          "unit": "cm"
	        },
	        "items": [
	          {
	            "description": "Samsung Galaxy Tab wifi 3G 64GB white",
	            "origin_country": "HKG",
	            "quantity": 2,
	            "price": {
	              "amount": 40,
	              "currency": "CNY"
	            },
	            "weight": {
	              "value": 0.4,
	              "unit": "kg"
	            },
	            "hs_code": "23528222"
	          },
	          {
	            "description": "Inches Quad-Core 3G Tablet PC With 1GB RAM, 16GB ROM Silver",
	            "origin_country": "HKG",
	            "quantity": 2,
	            "price": {
	              "amount": 40,
	              "currency": "CNY"
	            },
	            "weight": {
	              "value": 0.4,
	              "unit": "kg"
	            },
	            "hs_code": "23528222"
	          }
	        ]
	      }
	    ]
	  }
	}
	'''
	headers = {
	    'postmen-api-key': '8fc7966b-679b-4a57-911d-c5a663229c9e',
	    'content-type': 'application/json'
	}
	
	response = requests.request('POST', url, data=payload, headers=headers)
	
	print(response.text)
	

	require 'uri'
	require 'net/http'
	
	url = URI('https://sandbox-api.postmen.com/v3/labels')
	
	http = Net::HTTP.new(url.host, url.port)
	http.use_ssl = true
	
	request = Net::HTTP::Post.new(url)
	request['postmen-api-key'] = '8fc7966b-679b-4a57-911d-c5a663229c9e'
	request['content-type'] = 'application/json'
	request.body = '{"async":false,"return_shipment":false,"paper_size":"default","service_type":"sf-express-isp_standard_express","is_document":false,"service_options":[{"type":"insurance","insured_value":{"amount":10,"currency":"CNY"}}],"invoice":{"date":"2019-10-11"},"references":["13N11ME-MP"],"shipper_account":{"id":"00000000-0000-0000-0000-000000000000"},"customs":{"billing":{"paid_by":"recipient","method":{"type":"account","account_number":"AA00888AAAABBBB"}},"terms_of_trade":"ddu","purpose":"merchandise"},"billing":{"paid_by":"shipper"},"shipment":{"ship_from":{"contact_name":"美瑞克斯旗舰店","phone":"400-990-1503","company_name":"aftership(深圳)","street1":"郑州市经济开发区经北二路第九大街东500","city":"郑州市","email":"panda@aftership.com","state":"河南省","postal_code":"450000","country":"CHN","type":"business"},"ship_to":{"contact_name":"Panda","company_name":"Panda(TWN.Company)","phone":"+886-48331889-1238","email":"Panda@test.com","state":"广东省","street1":"深圳市粤兴三道112号","city":"深圳市","postal_code":"518000","country":"CHN","type":"residential"},"parcels":[{"description":"iMac (Retina 5K, 27-inch, Late 2014)","box_type":"custom","weight":{"value":9.84,"unit":"kg"},"dimension":{"width":65,"height":52,"depth":21,"unit":"cm"},"items":[{"description":"iMac (Retina 5K, 27-inch, Late 2017)","origin_country":"USA","quantity":1,"price":{"amount":1999,"currency":"CNY"},"weight":{"value":9.54,"unit":"kg"},"sku":"imac2014"},{"description":"Google Nexus 10","origin_country":"USA","quantity":1,"sku":"google man","price":{"amount":550,"currency":"CNY"},"weight":{"value":0.3,"unit":"kg"}}]},{"box_type":"custom","weight":{"unit":"kg","value":1.2},"dimension":{"depth":15,"width":10,"height":1,"unit":"in"},"items":[{"description":"Samsung Galaxy Tab wifi 3G 64GB black","origin_country":"USA","quantity":2,"price":{"amount":50,"currency":"CNY"},"weight":{"value":0.6,"unit":"kg"},"sku":"Epic_Food_Bar","hs_code":"215155"}]},{"box_type":"custom","weight":{"unit":"kg","value":1.6},"dimension":{"depth":5,"width":4,"height":3,"unit":"cm"},"items":[{"description":"Samsung Galaxy Tab wifi 3G 64GB white","origin_country":"HKG","quantity":2,"price":{"amount":40,"currency":"CNY"},"weight":{"value":0.4,"unit":"kg"},"hs_code":"23528222"},{"description":"Inches Quad-Core 3G Tablet PC With 1GB RAM, 16GB ROM Silver","origin_country":"HKG","quantity":2,"price":{"amount":40,"currency":"CNY"},"weight":{"value":0.4,"unit":"kg"},"hs_code":"23528222"}]}]}}'
	
	response = http.request(request)
	puts response.read_body
NameTypeDescription
id string Label ID
status string Accepts: creating,created,cancelling,cancelled,manifesting,manifested,failed.
ship_date string Ship Date in YYYY-MM-DD
tracking_numbers array of strings
files a files object A files object
rate rate type The amount of a charge or payment with reference to some basis of calculation.
created_at string A formatted date.
updated_at string A formatted date.
references array of strings Reference numbers for a label
shipper_account object account of shipper
service_type string Service Types Accepts: sf-express-isp_america_direct_ship,sf-express-isp_cloud_warehouse_next_day_delivery,sf-express-isp_cloud_warehouse_third_day_delivery,sf-express-isp_ecommerce_economy_express,sf-express-isp_ecommerce_express,sf-express-isp_ecommerce_special_delivery,sf-express-isp_economy_express,sf-express-isp_international_ecommerce_special_delivery,sf-express-isp_international_economy_express_document,sf-express-isp_international_economy_express_merchant_agent,sf-express-isp_international_economy_express_parcel,sf-express-isp_international_economy_express_pilot,sf-express-isp_international_heavy_freight,sf-express-isp_international_small_parcel,sf-express-isp_international_standard_express_document,sf-express-isp_international_standard_express_parcel,sf-express-isp_next_morning_delivery,sf-express-isp_register_mail,sf-express-isp_same_day_delivery,sf-express-isp_standard_express.

Response example

{
	  "meta": {
	    "code": 200,
	    "message": "OK",
	    "details": []
	  },
	  "data": {
	    "id": "00000000-0000-0000-0000-000000000000",
	    "status": "created",
	    "ship_date": "2019-11-01",
	    "created_at": "2019-11-01T00:00:00+00:00",
	    "updated_at": "2019-11-01T00:00:00+00:00",
	    "tracking_numbers": [
	      "SF235235235235"
	    ],
	    "files": {
	      "label": {
	        "paper_size": "default",
	        "url": "https://sandbox-download.postmen.com/label/2019-11-27/00000000-0000-0000-0000-000000000000-1441785264309885.pdf",
	        "file_type": "pdf"
	      },
	      "invoice": {
	        "paper_size": "a4",
	        "url": "https://sandbox-download.postmen.com/invoice/2019-11-27/00000000-0000-0000-0000-000000000000-1441785264309885.pdf",
	        "file_type": "pdf"
	      },
	      "customs_declaration": null,
	      "manifest": null
	    },
	    "rate": {
	      "shipper_account": {
	        "id": "00000000-0000-0000-0000-000000000000",
	        "slug": "sf-express-isp",
	        "description": "SF Express ISP"
	      },
	      "service_type": "sf-express-isp_standard_express",
	      "service_name": "Standard Express"
	    }
	  }
	}

GET Retrieve a label

Try it 
/labels/:id

Retrieve a label


	{}
	

	curl --request GET \
	    --url https://sandbox-api.postmen.com/v3/labels/ \
	    --header 'content-type: application/json' \
	    --header 'postmen-api-key: 8fc7966b-679b-4a57-911d-c5a663229c9e' \
	

	using System;
	using System.Net;
	using System.IO;
	
	class ExamplePostmen
	{
	    static void Main(string[] args)
		{
	        WebRequest httpWebRequest = WebRequest.Create("https://sandbox-api.postmen.com/v3/labels/");
	
	        httpWebRequest.ContentType = "application/json";
	        httpWebRequest.Method = "GET";
	        httpWebRequest.Headers["postmen-api-key"] = "8fc7966b-679b-4a57-911d-c5a663229c9e";
	
	        HttpWebResponse httpResponse = (HttpWebResponse)httpWebRequest.GetResponse();
	        using (StreamReader streamReader = new StreamReader(httpResponse.GetResponseStream()))
	        {
	            string result = streamReader.ReadToEnd();
	            Console.WriteLine(result);
	        }
	    }
	}
	

	import com.squareup.okhttp.*;
	
	public class test {
	
	    public static void main(String[] args) {
		    OkHttpClient client = new OkHttpClient();
	
	    	MediaType mediaType = MediaType.parse("application/json");
	
	    	Request request = new Request.Builder()
	    		.url("https://sandbox-api.postmen.com/v3/labels/")
	            .get()
	    		.addHeader("postmen-api-key", "8fc7966b-679b-4a57-911d-c5a663229c9e")
	    		.addHeader("content-type", "application/json")
	    		.build();
	
	    	try {
	    		Response response = client.newCall(request).execute();
	    		System.out.println(response.body().string());
	    	} catch (Exception e) {
	    		System.err.println("Caught IOException: " + e.getMessage());
	    	}
	    }
	}
	
var request = require("request");
	var options = {
		method: 'GET',
	    url: 'https://sandbox-api.postmen.com/v3/labels/',
	    headers: {
			'content-type': 'application/json',
	        'postmen-api-key': '8fc7966b-679b-4a57-911d-c5a663229c9e'
		}
	};
	
	request(options, function (error, response, body) {
	    if (error) throw new Error(error);
	    console.log(body);
	});

	<?php
	
	    $url = 'https://sandbox-api.postmen.com/v3/labels/';
	    $method = 'GET';
	    $headers = array(
	        "content-type: application/json",
	        "postmen-api-key: 8fc7966b-679b-4a57-911d-c5a663229c9e"
	    );
	
	    $curl = curl_init();
	
	    curl_setopt_array($curl, array(
	        CURLOPT_RETURNTRANSFER => true,
	        CURLOPT_URL => $url,
	        CURLOPT_CUSTOMREQUEST => $method,
	        CURLOPT_HTTPHEADER => $headers,
	    ));
	
	    $response = curl_exec($curl);
	    $err = curl_error($curl);
	
	    curl_close($curl);
	
	    if ($err) {
	    	echo "cURL Error #:" . $err;
	    } else {
	    	echo $response;
	    }
	?>
	

	# Make sure to install requests: pip install requests
	import requests
	
	url = 'https://sandbox-api.postmen.com/v3/labels/'
	
	headers = {
	    'postmen-api-key': '8fc7966b-679b-4a57-911d-c5a663229c9e',
	    'content-type': 'application/json'
	}
	
	response = requests.request('GET', url, headers=headers)
	
	print(response.text)
	

	require 'uri'
	require 'net/http'
	
	url = URI('https://sandbox-api.postmen.com/v3/labels/')
	
	http = Net::HTTP.new(url.host, url.port)
	http.use_ssl = true
	
	request = Net::HTTP::Get.new(url)
	request['postmen-api-key'] = '8fc7966b-679b-4a57-911d-c5a663229c9e'
	request['content-type'] = 'application/json'
	
	response = http.request(request)
	puts response.read_body
NameTypeDescription
id string Label ID
status string Accepts: creating,created,cancelling,cancelled,manifesting,manifested,failed.
ship_date string Ship Date in YYYY-MM-DD
tracking_numbers array of strings
files a files object A files object
rate rate type The amount of a charge or payment with reference to some basis of calculation.
created_at string A formatted date.
updated_at string A formatted date.

Response example

{
	  "id": "00000000-0000-0000-0000-000000000000",
	  "status": "created",
	  "ship_date": "2019-11-01",
	  "created_at": "2019-11-01T00:00:00+00:00",
	  "updated_at": "2019-11-01T00:00:00+00:00",
	  "tracking_numbers": [
	    "SF235235235235"
	  ],
	  "files": {
	    "label": {
	      "paper_size": "default",
	      "url": "https://sandbox-download.postmen.com/label/2019-11-27/00000000-0000-0000-0000-000000000000-1441785264309885.pdf",
	      "file_type": "pdf"
	    },
	    "invoice": {
	      "paper_size": "a4",
	      "url": "https://sandbox-download.postmen.com/invoice/2019-11-27/00000000-0000-0000-0000-000000000000-1441785264309885.pdf",
	      "file_type": "pdf"
	    },
	    "customs_declaration": null,
	    "manifest": null
	  },
	  "rate": {
	    "shipper_account": {
	      "id": "00000000-0000-0000-0000-000000000000",
	      "slug": "sf-express-isp",
	      "description": "SF Express ISP"
	    },
	    "service_type": "sf-express-isp_standard_express",
	    "service_name": "Standard Express"
	  }
	}

GET List all labels

Try it 
/labels

List all labels

NameTypeDescription
shipper_account_id string Shipper account ID
status string Label status Accepts: creating,created,cancelling,cancelled,manifesting,manifested,failed.
limit string Number of records per page
created_at_min string Start date and time of the record created (format YYYY-MM-DDTHH:MM:SSZ or YYYY-MM-DDTHH:MM:SS+00:00, default: 24hrs ago)
created_at_max string End date and time of the record created (format YYYY-MM-DDTHH:MM:SSZ or YYYY-MM-DDTHH:MM:SS+00:00, default: NOW())
tracking_numbers string Tracking numbers (separated by comma)
s string Partial search of tracking_number or reference
next_token string Next token

	{}
	

	curl --request GET \
	    --url https://sandbox-api.postmen.com/v3/labels \
	    --header 'content-type: application/json' \
	    --header 'postmen-api-key: 8fc7966b-679b-4a57-911d-c5a663229c9e' \
	

	using System;
	using System.Net;
	using System.IO;
	
	class ExamplePostmen
	{
	    static void Main(string[] args)
		{
	        WebRequest httpWebRequest = WebRequest.Create("https://sandbox-api.postmen.com/v3/labels");
	
	        httpWebRequest.ContentType = "application/json";
	        httpWebRequest.Method = "GET";
	        httpWebRequest.Headers["postmen-api-key"] = "8fc7966b-679b-4a57-911d-c5a663229c9e";
	
	        HttpWebResponse httpResponse = (HttpWebResponse)httpWebRequest.GetResponse();
	        using (StreamReader streamReader = new StreamReader(httpResponse.GetResponseStream()))
	        {
	            string result = streamReader.ReadToEnd();
	            Console.WriteLine(result);
	        }
	    }
	}
	

	import com.squareup.okhttp.*;
	
	public class test {
	
	    public static void main(String[] args) {
		    OkHttpClient client = new OkHttpClient();
	
	    	MediaType mediaType = MediaType.parse("application/json");
	
	    	Request request = new Request.Builder()
	    		.url("https://sandbox-api.postmen.com/v3/labels")
	            .get()
	    		.addHeader("postmen-api-key", "8fc7966b-679b-4a57-911d-c5a663229c9e")
	    		.addHeader("content-type", "application/json")
	    		.build();
	
	    	try {
	    		Response response = client.newCall(request).execute();
	    		System.out.println(response.body().string());
	    	} catch (Exception e) {
	    		System.err.println("Caught IOException: " + e.getMessage());
	    	}
	    }
	}
	
var request = require("request");
	var options = {
		method: 'GET',
	    url: 'https://sandbox-api.postmen.com/v3/labels',
	    headers: {
			'content-type': 'application/json',
	        'postmen-api-key': '8fc7966b-679b-4a57-911d-c5a663229c9e'
		}
	};
	
	request(options, function (error, response, body) {
	    if (error) throw new Error(error);
	    console.log(body);
	});

	<?php
	
	    $url = 'https://sandbox-api.postmen.com/v3/labels';
	    $method = 'GET';
	    $headers = array(
	        "content-type: application/json",
	        "postmen-api-key: 8fc7966b-679b-4a57-911d-c5a663229c9e"
	    );
	
	    $curl = curl_init();
	
	    curl_setopt_array($curl, array(
	        CURLOPT_RETURNTRANSFER => true,
	        CURLOPT_URL => $url,
	        CURLOPT_CUSTOMREQUEST => $method,
	        CURLOPT_HTTPHEADER => $headers,
	    ));
	
	    $response = curl_exec($curl);
	    $err = curl_error($curl);
	
	    curl_close($curl);
	
	    if ($err) {
	    	echo "cURL Error #:" . $err;
	    } else {
	    	echo $response;
	    }
	?>
	

	# Make sure to install requests: pip install requests
	import requests
	
	url = 'https://sandbox-api.postmen.com/v3/labels'
	
	headers = {
	    'postmen-api-key': '8fc7966b-679b-4a57-911d-c5a663229c9e',
	    'content-type': 'application/json'
	}
	
	response = requests.request('GET', url, headers=headers)
	
	print(response.text)
	

	require 'uri'
	require 'net/http'
	
	url = URI('https://sandbox-api.postmen.com/v3/labels')
	
	http = Net::HTTP.new(url.host, url.port)
	http.use_ssl = true
	
	request = Net::HTTP::Get.new(url)
	request['postmen-api-key'] = '8fc7966b-679b-4a57-911d-c5a663229c9e'
	request['content-type'] = 'application/json'
	
	response = http.request(request)
	puts response.read_body
NameTypeDescription
next_token string or null Any of string or null
limit number Number of records per page
labels array of a label object A label object

Response example

{
	  "meta": {
	    "code": 200,
	    "message": "OK",
	    "details": []
	  },
	  "data": {
	    "next_token": "eyJjcmVhdGVkX2F0IjoiMjAxNS0xMS0y0000000000oyMC4wNjRaIiwiaWQiOiJlMGU1NGQ3My1iN2Qz0000000000kzZi1lMjgwNzc1ZDdlMDUiLCJ1c2VyX2lkIjoiN0000000000tNjIyNS00ZTBiLTg5ZTQtZTM3N2M3YWM5ZDk4In0=",
	    "limit": 1,
	    "created_at_min": "2019-11-26T08:49:15+00:00",
	    "created_at_max": "2019-11-27T08:49:15+00:00",
	    "labels": [
	      {
	        "id": "00000000-0000-0000-0000-000000000000",
	        "status": "created",
	        "ship_date": "2019-11-01",
	        "created_at": "2019-11-01T00:00:00+00:00",
	        "updated_at": "2019-11-01T00:00:00+00:00",
	        "tracking_numbers": [
	          "SF235235235235"
	        ],
	        "files": {
	          "label": {
	            "paper_size": "default",
	            "url": "https://sandbox-download.postmen.com/label/2019-11-27/00000000-0000-0000-0000-000000000000-1441785264309885.pdf",
	            "file_type": "pdf"
	          },
	          "invoice": {
	            "paper_size": "a4",
	            "url": "https://sandbox-download.postmen.com/invoice/2019-11-27/00000000-0000-0000-0000-000000000000-1441785264309885.pdf",
	            "file_type": "pdf"
	          },
	          "customs_declaration": null,
	          "manifest": null
	        },
	        "rate": {
	          "shipper_account": {
	            "id": "00000000-0000-0000-0000-000000000000",
	            "slug": "sf-express-isp",
	            "description": "SF Express ISP"
	          },
	          "service_type": "sf-express-isp_standard_express",
	          "service_name": "Standard Express"
	        }
	      }
	    ]
	  }
	}

Cancel Labels

Cancel Labels

POST Cancel a label

Try it 
/cancel-labels

Cancel a label

NameTypeDescription
label * reference Object reference
async boolean enable async mode or not (set to false if not provided)

	{}
	

	curl --request POST \
	    --url https://sandbox-api.postmen.com/v3/cancel-labels \
	    --header 'content-type: application/json' \
	    --header 'postmen-api-key: 8fc7966b-679b-4a57-911d-c5a663229c9e' \
	

	using System;
	using System.Net;
	using System.IO;
	
	class ExamplePostmen
	{
	    static void Main(string[] args)
		{
	        WebRequest httpWebRequest = WebRequest.Create("https://sandbox-api.postmen.com/v3/cancel-labels");
	
	        httpWebRequest.ContentType = "application/json";
	        httpWebRequest.Method = "POST";
	        httpWebRequest.Headers["postmen-api-key"] = "8fc7966b-679b-4a57-911d-c5a663229c9e";
	
	        HttpWebResponse httpResponse = (HttpWebResponse)httpWebRequest.GetResponse();
	        using (StreamReader streamReader = new StreamReader(httpResponse.GetResponseStream()))
	        {
	            string result = streamReader.ReadToEnd();
	            Console.WriteLine(result);
	        }
	    }
	}
	

	import com.squareup.okhttp.*;
	
	public class test {
	
	    public static void main(String[] args) {
		    OkHttpClient client = new OkHttpClient();
	
	    	MediaType mediaType = MediaType.parse("application/json");
	
	    	Request request = new Request.Builder()
	    		.url("https://sandbox-api.postmen.com/v3/cancel-labels")
	            .post()
	    		.addHeader("postmen-api-key", "8fc7966b-679b-4a57-911d-c5a663229c9e")
	    		.addHeader("content-type", "application/json")
	    		.build();
	
	    	try {
	    		Response response = client.newCall(request).execute();
	    		System.out.println(response.body().string());
	    	} catch (Exception e) {
	    		System.err.println("Caught IOException: " + e.getMessage());
	    	}
	    }
	}
	
var request = require("request");
	var options = {
		method: 'POST',
	    url: 'https://sandbox-api.postmen.com/v3/cancel-labels',
	    headers: {
			'content-type': 'application/json',
	        'postmen-api-key': '8fc7966b-679b-4a57-911d-c5a663229c9e'
		}
	};
	
	request(options, function (error, response, body) {
	    if (error) throw new Error(error);
	    console.log(body);
	});

	<?php
	
	    $url = 'https://sandbox-api.postmen.com/v3/cancel-labels';
	    $method = 'POST';
	    $headers = array(
	        "content-type: application/json",
	        "postmen-api-key: 8fc7966b-679b-4a57-911d-c5a663229c9e"
	    );
	
	    $curl = curl_init();
	
	    curl_setopt_array($curl, array(
	        CURLOPT_RETURNTRANSFER => true,
	        CURLOPT_URL => $url,
	        CURLOPT_CUSTOMREQUEST => $method,
	        CURLOPT_HTTPHEADER => $headers,
	    ));
	
	    $response = curl_exec($curl);
	    $err = curl_error($curl);
	
	    curl_close($curl);
	
	    if ($err) {
	    	echo "cURL Error #:" . $err;
	    } else {
	    	echo $response;
	    }
	?>
	

	# Make sure to install requests: pip install requests
	import requests
	
	url = 'https://sandbox-api.postmen.com/v3/cancel-labels'
	
	headers = {
	    'postmen-api-key': '8fc7966b-679b-4a57-911d-c5a663229c9e',
	    'content-type': 'application/json'
	}
	
	response = requests.request('POST', url, headers=headers)
	
	print(response.text)
	

	require 'uri'
	require 'net/http'
	
	url = URI('https://sandbox-api.postmen.com/v3/cancel-labels')
	
	http = Net::HTTP.new(url.host, url.port)
	http.use_ssl = true
	
	request = Net::HTTP::Post.new(url)
	request['postmen-api-key'] = '8fc7966b-679b-4a57-911d-c5a663229c9e'
	request['content-type'] = 'application/json'
	
	response = http.request(request)
	puts response.read_body
NameTypeDescription
id string Cancel Label ID
status string Accepts: cancelling,cancelled,failed.
refund_status string Accepts: requested.
label reference Object reference
created_at string A formatted date.
updated_at string A formatted date.

Response example

No example available

GET List all cancel labels

Try it 
/cancel-labels

List all cancel labels

NameTypeDescription
shipper_account_id string Shipper account ID
status string Cancel Label status Accepts: cancelling,cancelled,failed.
limit string Number of records per page
created_at_min string Start date and time of the record created (format YYYY-MM-DDTHH:MM:SSZ or YYYY-MM-DDTHH:MM:SS+00:00, default: 24hrs ago)
created_at_max string End date and time of the record created (format YYYY-MM-DDTHH:MM:SSZ or YYYY-MM-DDTHH:MM:SS+00:00, default: NOW())
next_token string Next token

	{}
	

	curl --request GET \
	    --url https://sandbox-api.postmen.com/v3/cancel-labels \
	    --header 'content-type: application/json' \
	    --header 'postmen-api-key: 8fc7966b-679b-4a57-911d-c5a663229c9e' \
	

	using System;
	using System.Net;
	using System.IO;
	
	class ExamplePostmen
	{
	    static void Main(string[] args)
		{
	        WebRequest httpWebRequest = WebRequest.Create("https://sandbox-api.postmen.com/v3/cancel-labels");
	
	        httpWebRequest.ContentType = "application/json";
	        httpWebRequest.Method = "GET";
	        httpWebRequest.Headers["postmen-api-key"] = "8fc7966b-679b-4a57-911d-c5a663229c9e";
	
	        HttpWebResponse httpResponse = (HttpWebResponse)httpWebRequest.GetResponse();
	        using (StreamReader streamReader = new StreamReader(httpResponse.GetResponseStream()))
	        {
	            string result = streamReader.ReadToEnd();
	            Console.WriteLine(result);
	        }
	    }
	}
	

	import com.squareup.okhttp.*;
	
	public class test {
	
	    public static void main(String[] args) {
		    OkHttpClient client = new OkHttpClient();
	
	    	MediaType mediaType = MediaType.parse("application/json");
	
	    	Request request = new Request.Builder()
	    		.url("https://sandbox-api.postmen.com/v3/cancel-labels")
	            .get()
	    		.addHeader("postmen-api-key", "8fc7966b-679b-4a57-911d-c5a663229c9e")
	    		.addHeader("content-type", "application/json")
	    		.build();
	
	    	try {
	    		Response response = client.newCall(request).execute();
	    		System.out.println(response.body().string());
	    	} catch (Exception e) {
	    		System.err.println("Caught IOException: " + e.getMessage());
	    	}
	    }
	}
	
var request = require("request");
	var options = {
		method: 'GET',
	    url: 'https://sandbox-api.postmen.com/v3/cancel-labels',
	    headers: {
			'content-type': 'application/json',
	        'postmen-api-key': '8fc7966b-679b-4a57-911d-c5a663229c9e'
		}
	};
	
	request(options, function (error, response, body) {
	    if (error) throw new Error(error);
	    console.log(body);
	});

	<?php
	
	    $url = 'https://sandbox-api.postmen.com/v3/cancel-labels';
	    $method = 'GET';
	    $headers = array(
	        "content-type: application/json",
	        "postmen-api-key: 8fc7966b-679b-4a57-911d-c5a663229c9e"
	    );
	
	    $curl = curl_init();
	
	    curl_setopt_array($curl, array(
	        CURLOPT_RETURNTRANSFER => true,
	        CURLOPT_URL => $url,
	        CURLOPT_CUSTOMREQUEST => $method,
	        CURLOPT_HTTPHEADER => $headers,
	    ));
	
	    $response = curl_exec($curl);
	    $err = curl_error($curl);
	
	    curl_close($curl);
	
	    if ($err) {
	    	echo "cURL Error #:" . $err;
	    } else {
	    	echo $response;
	    }
	?>
	

	# Make sure to install requests: pip install requests
	import requests
	
	url = 'https://sandbox-api.postmen.com/v3/cancel-labels'
	
	headers = {
	    'postmen-api-key': '8fc7966b-679b-4a57-911d-c5a663229c9e',
	    'content-type': 'application/json'
	}
	
	response = requests.request('GET', url, headers=headers)
	
	print(response.text)
	

	require 'uri'
	require 'net/http'
	
	url = URI('https://sandbox-api.postmen.com/v3/cancel-labels')
	
	http = Net::HTTP.new(url.host, url.port)
	http.use_ssl = true
	
	request = Net::HTTP::Get.new(url)
	request['postmen-api-key'] = '8fc7966b-679b-4a57-911d-c5a663229c9e'
	request['content-type'] = 'application/json'
	
	response = http.request(request)
	puts response.read_body
NameTypeDescription
next_token string or null Any of string or null
limit number Number of records per page
cancel_labels array of a cancel label object A cancel label object

Response example

{
	  "meta": {
	    "code": 200,
	    "message": "OK",
	    "details": []
	  },
	  "data": {
	    "next_token": "eyJjcmVhdGVkX2F0IjoiMjAxNS0000000000Njo1MjozNC4zNjFaIiwiaWQiOiIwNGZlNDgz0000000000QxYzItYWUxOC1kNTEzZjNmMWNmMWEiLCJ1c2Vy0000000000RjNDY4NTAtNjIyNS00ZTBiLTg5ZTQtZTM3N2M3YWM5ZDk4In0=",
	    "limit": 20,
	    "created_at_min": "2015-11-26T08:58:59+00:00",
	    "created_at_max": "2015-11-27T08:58:59+00:00",
	    "cancel-labels": [
	      {
	        "id": "0e37b87a-684e-43cd-aaba-f0718e066519",
	        "status": "cancelled",
	        "label": {
	          "id": "166218cd-3e0a-4753-ac26-89ddabcd1dda"
	        },
	        "created_at": "2015-11-27T08:55:13+00:00",
	        "updated_at": "2015-11-27T08:55:14+00:00"
	      },
	      {
	        "id": "d05971fb-fddf-4243-ad58-7f34401b1da9",
	        "status": "cancelled",
	        "label": {
	          "id": "0426d03a-ae0d-4818-801c-4e92b31450da"
	        },
	        "created_at": "2015-11-27T08:52:35+00:00",
	        "updated_at": "2015-11-27T08:52:37+00:00"
	      },
	      {
	        "id": "cb404620-890b-4d37-9692-34ea08c4f111",
	        "status": "cancelled",
	        "label": {
	          "id": "df5769b0-60d0-4daf-8bad-bd164d64e12b"
	        },
	        "created_at": "2015-11-27T08:52:08+00:00",
	        "updated_at": "2015-11-27T08:52:09+00:00"
	      },
	      {
	        "id": "5472583e-3e55-492f-b1ab-5208de524e4e",
	        "status": "cancelled",
	        "label": {
	          "id": "72393fe3-be8e-4a7a-8434-1f0b5b56c09e"
	        },
	        "created_at": "2015-11-27T08:47:01+00:00",
	        "updated_at": "2015-11-27T08:47:02+00:00"
	      },
	      {
	        "id": "d4811447-fa1b-42a9-9820-09dfd57ed8e0",
	        "status": "cancelled",
	        "label": null,
	        "created_at": "2015-11-27T08:41:05+00:00",
	        "updated_at": "2015-11-27T08:41:05+00:00"
	      },
	      {
	        "id": "28e02aea-cd0c-4553-8a63-52bc98c29420",
	        "status": "cancelled",
	        "label": {
	          "id": "b3d75a21-9d27-4b1b-9592-485667f59e3f"
	        },
	        "created_at": "2015-11-27T08:25:12+00:00",
	        "updated_at": "2015-11-27T08:25:13+00:00"
	      },
	      {
	        "id": "39b4be71-f3d8-4d33-be15-fbf7be0b41d0",
	        "status": "cancelled",
	        "label": {
	          "id": "d88e9447-c84e-4e97-8d1f-ba98038a7a9e"
	        },
	        "created_at": "2015-11-27T08:22:35+00:00",
	        "updated_at": "2015-11-27T08:22:37+00:00"
	      },
	      {
	        "id": "6941fcfa-6e14-406c-9e9f-4a6f4fb550c1",
	        "status": "cancelled",
	        "label": {
	          "id": "2d4caaf4-1231-412d-bb94-62bae88ba785"
	        },
	        "created_at": "2015-11-27T08:22:09+00:00",
	        "updated_at": "2015-11-27T08:22:09+00:00"
	      },
	      {
	        "id": "263123da-c0c0-4fd1-bf1d-3936a788d272",
	        "status": "cancelled",
	        "label": {
	          "id": "9fc1f61b-7542-4015-a3dd-5dc4d4e8689b"
	        },
	        "created_at": "2015-11-27T08:17:00+00:00",
	        "updated_at": "2015-11-27T08:17:01+00:00"
	      },
	      {
	        "id": "38b34575-2081-4333-8779-78cab4d9a642",
	        "status": "cancelled",
	        "label": null,
	        "created_at": "2015-11-27T08:11:04+00:00",
	        "updated_at": "2015-11-27T08:11:04+00:00"
	      },
	      {
	        "id": "2944f236-6420-4f9f-8c20-b06daaf39f39",
	        "status": "cancelled",
	        "label": {
	          "id": "b05b2f29-9ed1-4844-90f6-a1ff13af56bb"
	        },
	        "created_at": "2015-11-27T07:55:12+00:00",
	        "updated_at": "2015-11-27T07:55:13+00:00"
	      },
	      {
	        "id": "0c074025-c4d9-47ce-bb89-ae854abe1a1b",
	        "status": "cancelled",
	        "label": {
	          "id": "04b151b1-deb1-41e8-afbe-726df8a7ff54"
	        },
	        "created_at": "2015-11-27T07:52:37+00:00",
	        "updated_at": "2015-11-27T07:52:38+00:00"
	      },
	      {
	        "id": "7c78c2a8-0ff0-4c80-bb99-9ae9037034e4",
	        "status": "cancelled",
	        "label": {
	          "id": "2afe41d0-70fe-4130-8e76-8d305e1f15dc"
	        },
	        "created_at": "2015-11-27T07:47:02+00:00",
	        "updated_at": "2015-11-27T07:47:02+00:00"
	      },
	      {
	        "id": "a0dd6cd0-00c6-4502-ba45-73369a010ca7",
	        "status": "cancelled",
	        "label": null,
	        "created_at": "2015-11-27T07:41:04+00:00",
	        "updated_at": "2015-11-27T07:41:04+00:00"
	      },
	      {
	        "id": "78e50de5-f5e9-455c-922d-2de14fe91952",
	        "status": "cancelled",
	        "label": {
	          "id": "b09f1969-e77f-42dc-94d0-32fe5d4b3337"
	        },
	        "created_at": "2015-11-27T07:25:13+00:00",
	        "updated_at": "2015-11-27T07:25:14+00:00"
	      },
	      {
	        "id": "a4a13f7a-66b1-410c-824c-b9edf9aada3a",
	        "status": "cancelled",
	        "label": {
	          "id": "9f783f53-c336-4de7-ad6d-b617614ba269"
	        },
	        "created_at": "2015-11-27T07:22:35+00:00",
	        "updated_at": "2015-11-27T07:22:36+00:00"
	      },
	      {
	        "id": "f3a97cbe-8792-478c-bfc2-7ab9be026760",
	        "status": "cancelled",
	        "label": {
	          "id": "7350085b-a11c-4b63-874e-15a542ee73d2"
	        },
	        "created_at": "2015-11-27T07:17:00+00:00",
	        "updated_at": "2015-11-27T07:17:00+00:00"
	      },
	      {
	        "id": "0f3f06c6-b52d-4fcb-a6a9-7f606991d79c",
	        "status": "cancelled",
	        "label": null,
	        "created_at": "2015-11-27T07:11:04+00:00",
	        "updated_at": "2015-11-27T07:11:04+00:00"
	      },
	      {
	        "id": "371186a1-67f3-434c-af79-18ce78ece73e",
	        "status": "cancelled",
	        "label": {
	          "id": "1e0af41f-e3d8-42ce-958c-117ebb72ebc5"
	        },
	        "created_at": "2015-11-27T06:55:13+00:00",
	        "updated_at": "2015-11-27T06:55:13+00:00"
	      },
	      {
	        "id": "04fe4835-8527-41c2-ae18-d513f3f1cf1a",
	        "status": "cancelled",
	        "label": {
	          "id": "f6a3d017-dd7f-42b9-abeb-c8104c130e0a"
	        },
	        "created_at": "2015-11-27T06:52:34+00:00",
	        "updated_at": "2015-11-27T06:52:35+00:00"
	      }
	    ]
	  }
	}

GET Retrieve a cancel label

Try it 
/cancel-labels/:id

Retrieve a cancel label


	{}
	

	curl --request GET \
	    --url https://sandbox-api.postmen.com/v3/cancel-labels/ \
	    --header 'content-type: application/json' \
	    --header 'postmen-api-key: 8fc7966b-679b-4a57-911d-c5a663229c9e' \
	

	using System;
	using System.Net;
	using System.IO;
	
	class ExamplePostmen
	{
	    static void Main(string[] args)
		{
	        WebRequest httpWebRequest = WebRequest.Create("https://sandbox-api.postmen.com/v3/cancel-labels/");
	
	        httpWebRequest.ContentType = "application/json";
	        httpWebRequest.Method = "GET";
	        httpWebRequest.Headers["postmen-api-key"] = "8fc7966b-679b-4a57-911d-c5a663229c9e";
	
	        HttpWebResponse httpResponse = (HttpWebResponse)httpWebRequest.GetResponse();
	        using (StreamReader streamReader = new StreamReader(httpResponse.GetResponseStream()))
	        {
	            string result = streamReader.ReadToEnd();
	            Console.WriteLine(result);
	        }
	    }
	}
	

	import com.squareup.okhttp.*;
	
	public class test {
	
	    public static void main(String[] args) {
		    OkHttpClient client = new OkHttpClient();
	
	    	MediaType mediaType = MediaType.parse("application/json");
	
	    	Request request = new Request.Builder()
	    		.url("https://sandbox-api.postmen.com/v3/cancel-labels/")
	            .get()
	    		.addHeader("postmen-api-key", "8fc7966b-679b-4a57-911d-c5a663229c9e")
	    		.addHeader("content-type", "application/json")
	    		.build();
	
	    	try {
	    		Response response = client.newCall(request).execute();
	    		System.out.println(response.body().string());
	    	} catch (Exception e) {
	    		System.err.println("Caught IOException: " + e.getMessage());
	    	}
	    }
	}
	
var request = require("request");
	var options = {
		method: 'GET',
	    url: 'https://sandbox-api.postmen.com/v3/cancel-labels/',
	    headers: {
			'content-type': 'application/json',
	        'postmen-api-key': '8fc7966b-679b-4a57-911d-c5a663229c9e'
		}
	};
	
	request(options, function (error, response, body) {
	    if (error) throw new Error(error);
	    console.log(body);
	});

	<?php
	
	    $url = 'https://sandbox-api.postmen.com/v3/cancel-labels/';
	    $method = 'GET';
	    $headers = array(
	        "content-type: application/json",
	        "postmen-api-key: 8fc7966b-679b-4a57-911d-c5a663229c9e"
	    );
	
	    $curl = curl_init();
	
	    curl_setopt_array($curl, array(
	        CURLOPT_RETURNTRANSFER => true,
	        CURLOPT_URL => $url,
	        CURLOPT_CUSTOMREQUEST => $method,
	        CURLOPT_HTTPHEADER => $headers,
	    ));
	
	    $response = curl_exec($curl);
	    $err = curl_error($curl);
	
	    curl_close($curl);
	
	    if ($err) {
	    	echo "cURL Error #:" . $err;
	    } else {
	    	echo $response;
	    }
	?>
	

	# Make sure to install requests: pip install requests
	import requests
	
	url = 'https://sandbox-api.postmen.com/v3/cancel-labels/'
	
	headers = {
	    'postmen-api-key': '8fc7966b-679b-4a57-911d-c5a663229c9e',
	    'content-type': 'application/json'
	}
	
	response = requests.request('GET', url, headers=headers)
	
	print(response.text)
	

	require 'uri'
	require 'net/http'
	
	url = URI('https://sandbox-api.postmen.com/v3/cancel-labels/')
	
	http = Net::HTTP.new(url.host, url.port)
	http.use_ssl = true
	
	request = Net::HTTP::Get.new(url)
	request['postmen-api-key'] = '8fc7966b-679b-4a57-911d-c5a663229c9e'
	request['content-type'] = 'application/json'
	
	response = http.request(request)
	puts response.read_body
NameTypeDescription
id string Label ID
status string Accepts: cancelling,cancelled,failed.
label reference Object reference
created_at string A formatted date.
updated_at string A formatted date.

Response example

No example available

Shipper Accounts

Shipper Accounts

POST Create a shipper account

Try it 
/shipper-accounts

Create a shipper account

NameTypeDescription
slug string Courier Slug Accepts: sf-express-isp.
description string The description of the account
address address - shipper account Address object
timezone string Use IANA — Time Zone Database Accepts: Africa/Abidjan,Africa/Accra,Africa/Addis_Ababa,Africa/Algiers,Africa/Asmara,Africa/Asmera,Africa/Bamako,Africa/Bangui,Africa/Banjul,Africa/Bissau,Africa/Blantyre,Africa/Brazzaville,Africa/Bujumbura,Africa/Cairo,Africa/Casablanca,Africa/Ceuta,Africa/Conakry,Africa/Dakar,Africa/Dar_es_Salaam,Africa/Djibouti,Africa/Douala,Africa/El_Aaiun,Africa/Freetown,Africa/Gaborone,Africa/Harare,Africa/Johannesburg,Africa/Juba,Africa/Kampala,Africa/Khartoum,Africa/Kigali,Africa/Kinshasa,Africa/Lagos,Africa/Libreville,Africa/Lome,Africa/Luanda,Africa/Lubumbashi,Africa/Lusaka,Africa/Malabo,Africa/Maputo,Africa/Maseru,Africa/Mbabane,Africa/Mogadishu,Africa/Monrovia,Africa/Nairobi,Africa/Ndjamena,Africa/Niamey,Africa/Nouakchott,Africa/Ouagadougou,Africa/Porto-Novo,Africa/Sao_Tome,Africa/Timbuktu,Africa/Tripoli,Africa/Tunis,Africa/Windhoek,America/Adak,America/Anchorage,America/Anguilla,America/Antigua,America/Araguaina,America/Argentina/Buenos_Aires,America/Argentina/Catamarca,America/Argentina/ComodRivadavia,America/Argentina/Cordoba,America/Argentina/Jujuy,America/Argentina/La_Rioja,America/Argentina/Mendoza,America/Argentina/Rio_Gallegos,America/Argentina/Salta,America/Argentina/San_Juan,America/Argentina/San_Luis,America/Argentina/Tucuman,America/Argentina/Ushuaia,America/Aruba,America/Asuncion,America/Atikokan,America/Atka,America/Bahia,America/Bahia_Banderas,America/Barbados,America/Belem,America/Belize,America/Blanc-Sablon,America/Boa_Vista,America/Bogota,America/Boise,America/Buenos_Aires,America/Cambridge_Bay,America/Campo_Grande,America/Cancun,America/Caracas,America/Catamarca,America/Cayenne,America/Cayman,America/Chicago,America/Chihuahua,America/Coral_Harbour,America/Cordoba,America/Costa_Rica,America/Creston,America/Cuiaba,America/Curacao,America/Danmarkshavn,America/Dawson,America/Dawson_Creek,America/Denver,America/Detroit,America/Dominica,America/Edmonton,America/Eirunepe,America/El_Salvador,America/Ensenada,America/Fort_Nelson,America/Fort_Wayne,America/Fortaleza,America/Glace_Bay,America/Godthab,America/Goose_Bay,America/Grand_Turk,America/Grenada,America/Guadeloupe,America/Guatemala,America/Guayaquil,America/Guyana,America/Halifax,America/Havana,America/Hermosillo,America/Indiana/Indianapolis,America/Indiana/Knox,America/Indiana/Marengo,America/Indiana/Petersburg,America/Indiana/Tell_City,America/Indiana/Vevay,America/Indiana/Vincennes,America/Indiana/Winamac,America/Indianapolis,America/Inuvik,America/Iqaluit,America/Jamaica,America/Jujuy,America/Juneau,America/Kentucky/Louisville,America/Kentucky/Monticello,America/Knox_IN,America/Kralendijk,America/La_Paz,America/Lima,America/Los_Angeles,America/Louisville,America/Lower_Princes,America/Maceio,America/Managua,America/Manaus,America/Marigot,America/Martinique,America/Matamoros,America/Mazatlan,America/Mendoza,America/Menominee,America/Merida,America/Metlakatla,America/Mexico_City,America/Miquelon,America/Moncton,America/Monterrey,America/Montevideo,America/Montreal,America/Montserrat,America/Nassau,America/New_York,America/Nipigon,America/Nome,America/Noronha,America/North_Dakota/Beulah,America/North_Dakota/Center,America/North_Dakota/New_Salem,America/Ojinaga,America/Panama,America/Pangnirtung,America/Paramaribo,America/Phoenix,America/Port-au-Prince,America/Port_of_Spain,America/Porto_Acre,America/Porto_Velho,America/Puerto_Rico,America/Punta_Arenas,America/Rainy_River,America/Rankin_Inlet,America/Recife,America/Regina,America/Resolute,America/Rio_Branco,America/Rosario,America/Santa_Isabel,America/Santarem,America/Santiago,America/Santo_Domingo,America/Sao_Paulo,America/Scoresbysund,America/Shiprock,America/Sitka,America/St_Barthelemy,America/St_Johns,America/St_Kitts,America/St_Lucia,America/St_Thomas,America/St_Vincent,America/Swift_Current,America/Tegucigalpa,America/Thule,America/Thunder_Bay,America/Tijuana,America/Toronto,America/Tortola,America/Vancouver,America/Virgin,America/Whitehorse,America/Winnipeg,America/Yakutat,America/Yellowknife,Antarctica/Casey,Antarctica/Davis,Antarctica/DumontDUrville,Antarctica/Macquarie,Antarctica/Mawson,Antarctica/McMurdo,Antarctica/Palmer,Antarctica/Rothera,Antarctica/South_Pole,Antarctica/Syowa,Antarctica/Troll,Antarctica/Vostok,Arctic/Longyearbyen,Asia/Aden,Asia/Almaty,Asia/Amman,Asia/Anadyr,Asia/Aqtau,Asia/Aqtobe,Asia/Ashgabat,Asia/Ashkhabad,Asia/Atyrau,Asia/Baghdad,Asia/Bahrain,Asia/Baku,Asia/Bangkok,Asia/Barnaul,Asia/Beirut,Asia/Bishkek,Asia/Brunei,Asia/Calcutta,Asia/Chita,Asia/Choibalsan,Asia/Chongqing,Asia/Chungking,Asia/Colombo,Asia/Dacca,Asia/Damascus,Asia/Dhaka,Asia/Dili,Asia/Dubai,Asia/Dushanbe,Asia/Famagusta,Asia/Gaza,Asia/Harbin,Asia/Hebron,Asia/Ho_Chi_Minh,Asia/Hong_Kong,Asia/Hovd,Asia/Irkutsk,Asia/Istanbul,Asia/Jakarta,Asia/Jayapura,Asia/Jerusalem,Asia/Kabul,Asia/Kamchatka,Asia/Karachi,Asia/Kashgar,Asia/Kathmandu,Asia/Katmandu,Asia/Khandyga,Asia/Kolkata,Asia/Krasnoyarsk,Asia/Kuala_Lumpur,Asia/Kuching,Asia/Kuwait,Asia/Macao,Asia/Macau,Asia/Magadan,Asia/Makassar,Asia/Manila,Asia/Muscat,Asia/Nicosia,Asia/Novokuznetsk,Asia/Novosibirsk,Asia/Omsk,Asia/Oral,Asia/Phnom_Penh,Asia/Pontianak,Asia/Pyongyang,Asia/Qatar,Asia/Qyzylorda,Asia/Rangoon,Asia/Riyadh,Asia/Saigon,Asia/Sakhalin,Asia/Samarkand,Asia/Seoul,Asia/Shanghai,Asia/Singapore,Asia/Srednekolymsk,Asia/Taipei,Asia/Tashkent,Asia/Tbilisi,Asia/Tehran,Asia/Tel_Aviv,Asia/Thimbu,Asia/Thimphu,Asia/Tokyo,Asia/Tomsk,Asia/Ujung_Pandang,Asia/Ulaanbaatar,Asia/Ulan_Bator,Asia/Urumqi,Asia/Ust-Nera,Asia/Vientiane,Asia/Vladivostok,Asia/Yakutsk,Asia/Yangon,Asia/Yekaterinburg,Asia/Yerevan,Atlantic/Azores,Atlantic/Bermuda,Atlantic/Canary,Atlantic/Cape_Verde,Atlantic/Faeroe,Atlantic/Faroe,Atlantic/Jan_Mayen,Atlantic/Madeira,Atlantic/Reykjavik,Atlantic/South_Georgia,Atlantic/St_Helena,Atlantic/Stanley,Australia/ACT,Australia/Adelaide,Australia/Brisbane,Australia/Broken_Hill,Australia/Canberra,Australia/Currie,Australia/Darwin,Australia/Eucla,Australia/Hobart,Australia/LHI,Australia/Lindeman,Australia/Lord_Howe,Australia/Melbourne,Australia/NSW,Australia/North,Australia/Perth,Australia/Queensland,Australia/South,Australia/Sydney,Australia/Tasmania,Australia/Victoria,Australia/West,Australia/Yancowinna,Brazil/Acre,Brazil/DeNoronha,Brazil/East,Brazil/West,Canada/Atlantic,Canada/Central,Canada/East-Saskatchewan,Canada/Eastern,Canada/Mountain,Canada/Newfoundland,Canada/Pacific,Canada/Saskatchewan,Canada/Yukon,Chile/Continental,Chile/EasterIsland,Europe/Amsterdam,Europe/Andorra,Europe/Astrakhan,Europe/Athens,Europe/Belfast,Europe/Belgrade,Europe/Berlin,Europe/Bratislava,Europe/Brussels,Europe/Bucharest,Europe/Budapest,Europe/Busingen,Europe/Chisinau,Europe/Copenhagen,Europe/Dublin,Europe/Gibraltar,Europe/Guernsey,Europe/Helsinki,Europe/Isle_of_Man,Europe/Istanbul,Europe/Jersey,Europe/Kaliningrad,Europe/Kiev,Europe/Kirov,Europe/Lisbon,Europe/Ljubljana,Europe/London,Europe/Luxembourg,Europe/Madrid,Europe/Malta,Europe/Mariehamn,Europe/Minsk,Europe/Monaco,Europe/Moscow,Europe/Nicosia,Europe/Oslo,Europe/Paris,Europe/Podgorica,Europe/Prague,Europe/Riga,Europe/Rome,Europe/Samara,Europe/San_Marino,Europe/Sarajevo,Europe/Saratov,Europe/Simferopol,Europe/Skopje,Europe/Sofia,Europe/Stockholm,Europe/Tallinn,Europe/Tirane,Europe/Tiraspol,Europe/Ulyanovsk,Europe/Uzhgorod,Europe/Vaduz,Europe/Vatican,Europe/Vienna,Europe/Vilnius,Europe/Volgograd,Europe/Warsaw,Europe/Zagreb,Europe/Zaporozhye,Europe/Zurich,Indian/Antananarivo,Indian/Chagos,Indian/Christmas,Indian/Cocos,Indian/Comoro,Indian/Kerguelen,Indian/Mahe,Indian/Maldives,Indian/Mauritius,Indian/Mayotte,Indian/Reunion,Mexico/BajaNorte,Mexico/BajaSur,Mexico/General,Pacific/Apia,Pacific/Auckland,Pacific/Bougainville,Pacific/Chatham,Pacific/Chuuk,Pacific/Easter,Pacific/Efate,Pacific/Enderbury,Pacific/Fakaofo,Pacific/Fiji,Pacific/Funafuti,Pacific/Galapagos,Pacific/Gambier,Pacific/Guadalcanal,Pacific/Guam,Pacific/Honolulu,Pacific/Johnston,Pacific/Kiritimati,Pacific/Kosrae,Pacific/Kwajalein,Pacific/Majuro,Pacific/Marquesas,Pacific/Midway,Pacific/Nauru,Pacific/Niue,Pacific/Norfolk,Pacific/Noumea,Pacific/Pago_Pago,Pacific/Palau,Pacific/Pitcairn,Pacific/Pohnpei,Pacific/Ponape,Pacific/Port_Moresby,Pacific/Rarotonga,Pacific/Saipan,Pacific/Samoa,Pacific/Tahiti,Pacific/Tarawa,Pacific/Tongatapu,Pacific/Truk,Pacific/Wake,Pacific/Wallis,Pacific/Yap,US/Alaska,US/Aleutian,US/Arizona,US/Central,US/East-Indiana,US/Eastern,US/Hawaii,US/Indiana-Starke,US/Michigan,US/Mountain,US/Pacific,US/Pacific-New,US/Samoa,UTC.
credentials shipper account credentials Shipper Account Credentials
settings shipper account settings Shipper Account Settings
NameTypeDescription
id string Shipper Account ID
address address - shipper account Address object
slug string The slug of the shipper_account
status string The current status of the shipper account Accepts: enabled,disabled,deleted.
description string The description of the account
type string The type of the shipper_account Accepts: user,user_prepaid.
timezone string Use IANA — Time Zone Database
created_at string A formatted date.
settings shipper account settings Shipper Account Settings
updated_at string A formatted date.

Response example

No example available

DELETE Delete a shipper account

Try it 
/shipper-accounts/:id

Delete a shipper account

NameTypeDescription
id string id of referring object

Response example

No example available

GET List all shipper accounts

Try it 
/shipper-accounts

List all shipper accounts

NameTypeDescription
slug string Courier slug
limit string Number of records per page
next_token string Next token
NameTypeDescription
next_token string or null Any of string or null
limit string Number of records per page
shipper_accounts array of a shipper_account object A shipper_account object

Response example

No example available

GET Retrieve a shipper account

Try it 
/shipper-accounts/:id

Retrieve a shipper account

NameTypeDescription
id string Shipper Account ID
address address - shipper account Address object
slug string The slug of the shipper_account
status string The current status of the shipper account Accepts: enabled,disabled,deleted.
description string The description of the account
type string The type of the shipper_account Accepts: user,user_prepaid.
timezone string Use IANA — Time Zone Database
created_at string A formatted date.
updated_at string A formatted date.

Response example

No example available

PUT Update a shipper account credentials

Try it 
/shipper-accounts/:id/credentials

Update a shipper account credentials

NameTypeDescription
account_number string
partner_id string
partner_token string
aes_key string
hmac_sha512_key string
origin_code string
NameTypeDescription
id string id of referring object

Response example

No example available

PUT Update a shipper account information

Try it 
/shipper-accounts/:id/info

Update a shipper account information

NameTypeDescription
description string The description of the account
timezone string Use IANA — Time Zone Database
credentials shipper account credentials Shipper Account Credentials
address address - shipper account Address object
NameTypeDescription
id string Shipper Account ID
address address - shipper account Address object
slug string The slug of the shipper_account
status string The current status of the shipper account Accepts: enabled,disabled,deleted.
description string The description of the account
type string The type of the shipper_account Accepts: user,user_prepaid.
timezone string Use IANA — Time Zone Database
created_at string A formatted date.
updated_at string A formatted date.

Response example

No example available

PUT Update a shipper account

Try it 
/shipper-accounts/:id

Update a shipper account

NameTypeDescription

Response example

No example available

Bulk Downloads

Bulk Downloads

NameTypeDescription

POST Create a bulk download

Try it 
/bulk-downloads

Create a bulk download

NameTypeDescription
labels * array of reference Object reference
async boolean enable async mode or not (set to false if not provided)
NameTypeDescription
id string Bulk download label ID
status string Accepts: creating,created,failed.
files a files object A files object
labels array of reference Object reference
invalid_labels array of reference Object reference
created_at string A formatted date.
updated_at string A formatted date.

Response example

No example available

GET List all bulk downloads

Try it 
/bulk-downloads

List all bulk downloads

NameTypeDescription
status string Bulk Download Status Accepts: creating,created,failed.
limit string Number of records per page
created_at_min string Start date and time of the record created (format YYYY-MM-DDTHH:MM:SSZ or YYYY-MM-DDTHH:MM:SS+00:00, default: 24hrs ago)
created_at_max string End date and time of the record created (format YYYY-MM-DDTHH:MM:SSZ or YYYY-MM-DDTHH:MM:SS+00:00, default: NOW())
next_token string Next token
NameTypeDescription
bulk_downloads array of a bulk download object A bulk download object

Response example

No example available

GET Retrieve a bulk download

Try it 
/bulk-downloads/:id

Retrieve a bulk download

NameTypeDescription
id string Bulk download label ID
status string Accepts: creating,created,failed.
files a files object A files object
labels array of reference Object reference
invalid_labels array of reference Object reference
created_at string A formatted date.
updated_at string A formatted date.

Response example

No example available

Address Validations

Address Validations

NameTypeDescription

POST Create an address validation

Try it 
/address-validations

Create an address validation

NameTypeDescription
address * address - address validation Address object

Request example

	{
	  "address": {
	    "contact_name": "testing",
	    "street1": "4901 N New Hope Rd Apt C1",
	    "city": "Raleigh",
	    "state": "NC",
	    "postal_code": "27604",
	    "country": "USA",
	    "type": "business",
	    "phone": "17578976058",
	    "email": "testing@gmail.com"
	  }
	}
NameTypeDescription
id string Request ID
status string Validation result of the address. Accepts: valid,invalid.
created_at string A formatted date.
updated_at string A formatted date.
address address - address validation Address object
recommended_address address - address validation Address object

Response example

	{
	  "meta": {
	    "code": 200,
	    "message": "OK",
	    "details": []
	  },
	  "data": {
	    "id": "b234f43e-a87f-4b97-baf8-dc49fefd5110",
	    "status": "valid",
	    "created_at": "2021-03-01T09:22:40Z",
	    "updated_at": "2021-03-01T09:22:45Z",
	    "address": {
	      "country": "USA",
	      "contact_name": "testing",
	      "phone": "17578976058",
	      "fax": null,
	      "email": "testing@gmail.com",
	      "company_name": null,
	      "street1": "4901 N New Hope Rd Apt C1",
	      "street2": null,
	      "street3": null,
	      "city": "Raleigh",
	      "state": "NC",
	      "postal_code": "27604",
	      "type": "business",
	      "tax_id": null
	    },
	    "recommended_address": {
	      "country": "USA",
	      "contact_name": null,
	      "phone": null,
	      "fax": null,
	      "email": null,
	      "company_name": null,
	      "street1": "4901 N NEW HOPE RD APT C1",
	      "street2": null,
	      "street3": null,
	      "city": "RALEIGH",
	      "state": "NC",
	      "postal_code": "27604-4494",
	      "type": null,
	      "tax_id": null
	    }
	  }
	}

Billing

Billing Object

NameTypeDescription
paid_by * string Accepts: shipper,recipient,third_party.
method payment method - account Payment Method - Account

Customs

Customs Object

NameTypeDescription
purpose * string Accepts: gift,merchandise,personal,sample,return,repair.
terms_of_trade string Accepts: dat,ddu,ddp,dap.
eei aes or no_eei EEI
billing customs billing Customs Billing Object
importer_address address Address object
passport passport Passport Object, if imported into China, you can set the customer's identification information in this object.

Shipment

An instance of shipping freight or cargo

NameTypeDescription
ship_from * ship from address Address object
ship_to * ship to address Address object
parcels * array of parcel packages of shipment An object or collection of objects wrapped in paper in order to be carried or sent by post.
return_to return to address Address object
delivery_instructions string Instructions to aid in prompt delivery of the shipment.

Address

Address object

NameTypeDescription
country * string Country in ISO 3166-1 alpha 3 code Accepts: ABW,AFG,AGO,AIA,ALA,ALB,AND,ANT,ARE,ARG,ARM,ASM,ATA,ATF,ATG,AUS,AUT,AZE,BDI,BEL,BEN,BES,BFA,BGD,BGR,BHR,BHS,BIH,BLM,BLR,BLZ,BMU,BOL,BRA,BRB,BRN,BTN,BVT,BWA,CAF,CAN,CCK,CHE,CHL,CHN,CIV,CMR,COD,COG,COK,COL,COM,CPV,CRI,CUB,CUW,CXR,CYM,CYP,CZE,DEU,DJI,DMA,DNK,DOM,DZA,ECU,EGY,ERI,ESH,ESP,EST,ETH,FIN,FJI,FLK,FRA,FRO,FSM,GAB,GBR,GEO,GGY,GHA,GIB,GIN,GLP,GMB,GNB,GNQ,GRC,GRD,GRL,GTM,GUF,GUM,GUY,HKG,HMD,HND,HRV,HTI,HUN,IDN,IMN,IND,IOT,IRL,IRN,IRQ,ISL,ISR,ITA,JAM,JEY,JOR,JPN,KAZ,KEN,KGZ,KHM,KIR,KNA,KOR,KWT,LAO,LBN,LBR,LBY,LCA,LIE,LKA,LSO,LTU,LUX,LVA,MAC,MAF,MAR,MCO,MDA,MDG,MDV,MEX,MHL,MKD,MLI,MLT,MMR,MNE,MNG,MNP,MOZ,MRT,MSR,MTQ,MUS,MWI,MYS,MYT,NAM,NCL,NER,NFK,NGA,NIC,NIU,NLD,NOR,NPL,NRU,NZL,OMN,PAK,PAN,PCN,PER,PHL,PLW,PNG,POL,PRI,PRK,PRT,PRY,PSE,PYF,QAT,REU,ROU,RUS,RWA,SAU,SDN,SEN,SGP,SGS,SHN,SJM,SLB,SLE,SLV,SMR,SOM,SPM,SRB,SSD,STP,SUR,SVK,SVN,SWE,SWZ,SXM,SYC,SYR,TCA,TCD,TGO,THA,TJK,TKL,TKM,TLS,TON,TTO,TUN,TUR,TUV,TWN,TZA,UGA,UKR,UMI,UNK,URY,USA,UZB,VAT,VCT,VEN,VGB,VIR,VNM,VUT,WLF,WSM,YEM,ZAF,ZMB,ZWE.
contact_name string contact_name of address
phone string contact_phone of address
fax string fax_number of address
email string email of address
company_name string company_name of address
street1 string address_line1 of address
street2 string address_line2 of address
street3 string address_line3 of address
city string city of address
state string state of address
postal_code string postal_code of address
type string type of address Accepts: business,residential.
tax_id string tax id

Parcel

An object or collection of objects wrapped in paper in order to be carried or sent by post.

NameTypeDescription
box_type * string Type of box for packaging Accepts: custom.
dimension * dimension dimension object
items * array of item items of package Item object, use to describe product to ship
description string The description of the parcel
weight weight weight object

Item

Item object, use to describe product to ship

NameTypeDescription
description * string The description of the item
quantity * integer The quantity for the item Minimum: 1
price * money money object
item_id string The ID of the item
origin_country string Country in ISO 3166-1 alpha 3 code Accepts: ABW,AFG,AGO,AIA,ALA,ALB,AND,ANT,ARE,ARG,ARM,ASM,ATA,ATF,ATG,AUS,AUT,AZE,BDI,BEL,BEN,BES,BFA,BGD,BGR,BHR,BHS,BIH,BLM,BLR,BLZ,BMU,BOL,BRA,BRB,BRN,BTN,BVT,BWA,CAF,CAN,CCK,CHE,CHL,CHN,CIV,CMR,COD,COG,COK,COL,COM,CPV,CRI,CUB,CUW,CXR,CYM,CYP,CZE,DEU,DJI,DMA,DNK,DOM,DZA,ECU,EGY,ERI,ESH,ESP,EST,ETH,FIN,FJI,FLK,FRA,FRO,FSM,GAB,GBR,GEO,GGY,GHA,GIB,GIN,GLP,GMB,GNB,GNQ,GRC,GRD,GRL,GTM,GUF,GUM,GUY,HKG,HMD,HND,HRV,HTI,HUN,IDN,IMN,IND,IOT,IRL,IRN,IRQ,ISL,ISR,ITA,JAM,JEY,JOR,JPN,KAZ,KEN,KGZ,KHM,KIR,KNA,KOR,KWT,LAO,LBN,LBR,LBY,LCA,LIE,LKA,LSO,LTU,LUX,LVA,MAC,MAF,MAR,MCO,MDA,MDG,MDV,MEX,MHL,MKD,MLI,MLT,MMR,MNE,MNG,MNP,MOZ,MRT,MSR,MTQ,MUS,MWI,MYS,MYT,NAM,NCL,NER,NFK,NGA,NIC,NIU,NLD,NOR,NPL,NRU,NZL,OMN,PAK,PAN,PCN,PER,PHL,PLW,PNG,POL,PRI,PRK,PRT,PRY,PSE,PYF,QAT,REU,ROU,RUS,RWA,SAU,SDN,SEN,SGP,SGS,SHN,SJM,SLB,SLE,SLV,SMR,SOM,SPM,SRB,SSD,STP,SUR,SVK,SVN,SWE,SWZ,SXM,SYC,SYR,TCA,TCD,TGO,THA,TJK,TKL,TKM,TLS,TON,TTO,TUN,TUR,TUV,TWN,TZA,UGA,UKR,UMI,UNK,URY,USA,UZB,VAT,VCT,VEN,VGB,VIR,VNM,VUT,WLF,WSM,YEM,ZAF,ZMB,ZWE.
weight weight weight object
sku string The sku of the item.
hs_code string The HS Code (Harmonized Commodity Description and Coding System) of the item.

A QR code file object

A QR code file object

NameTypeDescription
paper_size * string Paper Size Accepts: 1x1.
url * string URL of the file
file_type * string File Type Accepts: png.

A bulk download object

A bulk download object

NameTypeDescription
id string Bulk download label ID
status string Accepts: creating,created,failed.
files a files object A files object
labels array of reference Object reference
invalid_labels array of reference Object reference
created_at string A formatted date.
updated_at string A formatted date.

A cancel label object

A cancel label object

NameTypeDescription
id string Label ID
status string Accepts: cancelling,cancelled,failed.
refund_status string Accepts: requested,approved,rejected,refunded,expired.
label reference Object reference
created_at string A formatted date.
updated_at string A formatted date.

A customs declaration file object

A customs declaration file object

NameTypeDescription
paper_size * string Paper Size Accepts: 4x8,a4.
url * string URL of the file
file_type * string File Type Accepts: pdf.

A invoice file object

A invoice file object

NameTypeDescription
paper_size * string Paper Size Accepts: a4.
url * string URL of the file
file_type * string File Type Accepts: pdf.

A label file object

A label file object

NameTypeDescription
paper_size * string Label Paper Size Accepts: default. (set to "default" if not provided)
url * string URL of the file
file_type * string Label file type Accepts: pdf. (set to "pdf" if not provided)

A label object

A label object

NameTypeDescription
id string Label ID
status string Accepts: creating,created,cancelling,cancelled,manifesting,manifested,failed.
ship_date string Ship Date in YYYY-MM-DD
tracking_numbers array of strings
files a files object A files object
rate rate type The amount of a charge or payment with reference to some basis of calculation.
created_at string A formatted date.
updated_at string A formatted date.

A manifest PDF file object

A manifest PDF file object

NameTypeDescription
paper_size * string Paper Size Accepts: a4.
url string URL of the file
file_type string File Type Accepts: pdf.

A manifest common file object

A manifest common file object

NameTypeDescription
url string URL of the file
paper_size string Paper Size Accepts: a4.
file_type string File Type Accepts: csv,dat,zip,txt,tsv.

A manifest object

A manifest object

NameTypeDescription
id string Manifest ID
status string Accepts: manifesting,manifested,failed.
shipper_account reference Object reference
labels array of a manifesting label object A manifesting label object
files a files object A files object
created_at string A formatted date.
updated_at string A formatted date.

A manifesting label object

A manifesting label object

NameTypeDescription
id * string Label ID
manifested * boolean

A rate record object

A rate record object

NameTypeDescription
id string Calculate Rate ID
status string Accepts: calculating,calculated,failed.
rates array of rate type The amount of a charge or payment with reference to some basis of calculation.
created_at string A formatted date.
updated_at string A formatted date.

A shipper_account object

A shipper_account object

NameTypeDescription
id string Shipper Account ID
address address - shipper account Address object
slug string The slug of the shipper_account
status string The current status of the shipper account Accepts: enabled,disabled,deleted.
description string The description of the account
type string The type of the shipper_account Accepts: user,user_prepaid.
timezone string Use IANA — Time Zone Database
created_at string A formatted date.
updated_at string A formatted date.

Address - Address Validation

Address object

NameTypeDescription
street1 * string address_line1 of address
country * string Country in ISO 3166-1 alpha 3 code Accepts: USA.
contact_name string contact_name of address
phone string contact_phone of address
fax string fax_number of address
email string email of address
company_name string company_name of address
street2 string address_line2 of address
street3 string address_line3 of address
city string city of address
state string state of address
postal_code string postal_code of address
type string type of address Accepts: business,residential.
tax_id string tax id

Address - Shipper Account

Address object

NameTypeDescription
contact_name string contact_name of address
phone string contact_phone of address
fax string fax_number of address
email string email of address
company_name string company_name of address
street1 string address_line1 of address
street2 string address_line2 of address
street3 string address_line3 of address
city string city of address
state string state of address
postal_code string postal_code of address
country string Country in ISO 3166-1 alpha 3 code Accepts: ABW,AFG,AGO,AIA,ALA,ALB,AND,ANT,ARE,ARG,ARM,ASM,ATA,ATF,ATG,AUS,AUT,AZE,BDI,BEL,BEN,BES,BFA,BGD,BGR,BHR,BHS,BIH,BLM,BLR,BLZ,BMU,BOL,BRA,BRB,BRN,BTN,BVT,BWA,CAF,CAN,CCK,CHE,CHL,CHN,CIV,CMR,COD,COG,COK,COL,COM,CPV,CRI,CUB,CUW,CXR,CYM,CYP,CZE,DEU,DJI,DMA,DNK,DOM,DZA,ECU,EGY,ERI,ESH,ESP,EST,ETH,FIN,FJI,FLK,FRA,FRO,FSM,GAB,GBR,GEO,GGY,GHA,GIB,GIN,GLP,GMB,GNB,GNQ,GRC,GRD,GRL,GTM,GUF,GUM,GUY,HKG,HMD,HND,HRV,HTI,HUN,IDN,IMN,IND,IOT,IRL,IRN,IRQ,ISL,ISR,ITA,JAM,JEY,JOR,JPN,KAZ,KEN,KGZ,KHM,KIR,KNA,KOR,KWT,LAO,LBN,LBR,LBY,LCA,LIE,LKA,LSO,LTU,LUX,LVA,MAC,MAF,MAR,MCO,MDA,MDG,MDV,MEX,MHL,MKD,MLI,MLT,MMR,MNE,MNG,MNP,MOZ,MRT,MSR,MTQ,MUS,MWI,MYS,MYT,NAM,NCL,NER,NFK,NGA,NIC,NIU,NLD,NOR,NPL,NRU,NZL,OMN,PAK,PAN,PCN,PER,PHL,PLW,PNG,POL,PRI,PRK,PRT,PRY,PSE,PYF,QAT,REU,ROU,RUS,RWA,SAU,SDN,SEN,SGP,SGS,SHN,SJM,SLB,SLE,SLV,SMR,SOM,SPM,SRB,SSD,STP,SUR,SVK,SVN,SWE,SWZ,SXM,SYC,SYR,TCA,TCD,TGO,THA,TJK,TKL,TKM,TLS,TON,TTO,TUN,TUR,TUV,TWN,TZA,UGA,UKR,UMI,UNK,URY,USA,UZB,VAT,VCT,VEN,VGB,VIR,VNM,VUT,WLF,WSM,YEM,ZAF,ZMB,ZWE.
type string type of address Accepts: business,residential.
tax_id string tax id

Customs Billing

Customs Billing Object

NameTypeDescription
paid_by * string Accepts: shipper,recipient,third_party.
method payment method - account Payment Method - Account

Customs Declaration

Customs Declaration object

NameTypeDescription
number_of_copies integer Minimum: 1 , Maximum: 4

Detailed Charges

Detailed Charges object

NameTypeDescription
type string Detailed charges e.g. base, tax, fuel, discount etc.
charge money money object

Dimension

dimension object

NameTypeDescription
width * number width
height * number height
depth * number depth
unit * string unit Accepts: cm,in,mm,m,ft,yd.

FTP

FTP credentials object

NameTypeDescription
url * string protocol://domain + port + path
username * string username for ftp upload
password * string password for ftp upload

FTP

FTP credentials object

NameTypeDescription
username * string username for ftp upload
password * string password for ftp upload

Invoice

Invoice object, used to describe invoice type. Optional. Commercial invoice will be generated if field is present in the request body, else not.

NameTypeDescription
date * string Invoice date in YYYY-MM-DD
number string Invoice number
type string Accepts: commercial,proforma.
number_of_copies integer Minimum: 1 , Maximum: 4

Money

money object

NameTypeDescription
amount * number amount
currency * string Currency in ISO 4217 code Accepts: AED,AFN,ALL,AMD,ANG,AOA,ARS,AUD,AWG,AZN,BAM,BBD,BDT,BGN,BHD,BIF,BMD,BND,BOB,BOV,BRL,BSD,BTN,BWP,BYR,BZD,CAD,CDF,CHE,CHF,CHW,CLF,CLP,CNY,COP,COU,CRC,CUC,CUP,CVE,CZK,DJF,DKK,DOP,DZD,EGP,ERN,ETB,EUR,FJD,FKP,GBP,GEL,GHS,GIP,GMD,GNF,GTQ,GYD,HKD,HNL,HRK,HTG,HUF,IDR,ILS,INR,IQD,IRR,ISK,JMD,JOD,JPY,KES,KGS,KHR,KMF,KPW,KRW,KWD,KYD,KZT,LAK,LBP,LKR,LRD,LSL,LTL,LVL,LYD,MAD,MDL,MGA,MKD,MMK,MNT,MOP,MRO,MUR,MVR,MWK,MXN,MXV,MYR,MZN,NAD,NGN,NIO,NOK,NPR,NZD,OMR,PAB,PEN,PGK,PHP,PKR,PLN,PYG,QAR,RON,RSD,RUB,RWF,SAR,SBD,SCR,SDG,SEK,SGD,SHP,SLL,SOS,SRD,SSP,STD,SYP,SZL,THB,TJS,TMT,TND,TOP,TRY,TTD,TWD,TZS,UAH,UGX,USD,USN,USS,UYI,UYU,UZS,VEF,VND,VUV,WST,XAF,XAG,XAU,XBA,XBB,XBC,XBD,XCD,XDR,XFU,XOF,XPD,XPF,XPT,XTS,XXX,YER,ZAR,ZMW.

Passport

Passport Object, if imported into China, you can set the customer's identification information in this object.

NameTypeDescription
number * string Passport Number
issue_date * string Issue Date in YYYY-MM-DD

Payment Method - Account

Payment Method - Account

NameTypeDescription
type * string Accepts: account.
account_number * string account number
postal_code string Postal code
country string Country in ISO 3166-1 alpha 3 code Accepts: ABW,AFG,AGO,AIA,ALA,ALB,AND,ANT,ARE,ARG,ARM,ASM,ATA,ATF,ATG,AUS,AUT,AZE,BDI,BEL,BEN,BES,BFA,BGD,BGR,BHR,BHS,BIH,BLM,BLR,BLZ,BMU,BOL,BRA,BRB,BRN,BTN,BVT,BWA,CAF,CAN,CCK,CHE,CHL,CHN,CIV,CMR,COD,COG,COK,COL,COM,CPV,CRI,CUB,CUW,CXR,CYM,CYP,CZE,DEU,DJI,DMA,DNK,DOM,DZA,ECU,EGY,ERI,ESH,ESP,EST,ETH,FIN,FJI,FLK,FRA,FRO,FSM,GAB,GBR,GEO,GGY,GHA,GIB,GIN,GLP,GMB,GNB,GNQ,GRC,GRD,GRL,GTM,GUF,GUM,GUY,HKG,HMD,HND,HRV,HTI,HUN,IDN,IMN,IND,IOT,IRL,IRN,IRQ,ISL,ISR,ITA,JAM,JEY,JOR,JPN,KAZ,KEN,KGZ,KHM,KIR,KNA,KOR,KWT,LAO,LBN,LBR,LBY,LCA,LIE,LKA,LSO,LTU,LUX,LVA,MAC,MAF,MAR,MCO,MDA,MDG,MDV,MEX,MHL,MKD,MLI,MLT,MMR,MNE,MNG,MNP,MOZ,MRT,MSR,MTQ,MUS,MWI,MYS,MYT,NAM,NCL,NER,NFK,NGA,NIC,NIU,NLD,NOR,NPL,NRU,NZL,OMN,PAK,PAN,PCN,PER,PHL,PLW,PNG,POL,PRI,PRK,PRT,PRY,PSE,PYF,QAT,REU,ROU,RUS,RWA,SAU,SDN,SEN,SGP,SGS,SHN,SJM,SLB,SLE,SLV,SMR,SOM,SPM,SRB,SSD,STP,SUR,SVK,SVN,SWE,SWZ,SXM,SYC,SYR,TCA,TCD,TGO,THA,TJK,TKL,TKM,TLS,TON,TTO,TUN,TUR,TUV,TWN,TZA,UGA,UKR,UMI,UNK,URY,USA,UZB,VAT,VCT,VEN,VGB,VIR,VNM,VUT,WLF,WSM,YEM,ZAF,ZMB,ZWE.

Postmen error

An error object containing information about what went wrong.

NameTypeDescription
code integer
message string
details array of postmen meta A meta object containing information about what went wrong.
retryable boolean

Postmen meta

A meta object containing information about what went wrong.

NameTypeDescription
path string
info string

Rate type

The amount of a charge or payment with reference to some basis of calculation.

NameTypeDescription
shipper_account * shipper account information Shipper Account (brief information for rate and manifest responses)
service_type * string Service Types Accepts: sf-express-isp_america_direct_ship,sf-express-isp_cloud_warehouse_next_day_delivery,sf-express-isp_cloud_warehouse_third_day_delivery,sf-express-isp_ecommerce_economy_express,sf-express-isp_ecommerce_express,sf-express-isp_ecommerce_special_delivery,sf-express-isp_economy_express,sf-express-isp_international_ecommerce_special_delivery,sf-express-isp_international_economy_express_document,sf-express-isp_international_economy_express_merchant_agent,sf-express-isp_international_economy_express_parcel,sf-express-isp_international_economy_express_pilot,sf-express-isp_international_heavy_freight,sf-express-isp_international_small_parcel,sf-express-isp_international_standard_express_document,sf-express-isp_international_standard_express_parcel,sf-express-isp_next_morning_delivery,sf-express-isp_register_mail,sf-express-isp_same_day_delivery,sf-express-isp_standard_express.
service_name * string name of service
charge_weight weight weight object
total_charge money money object
pickup_deadline string A formatted date.
booking_cut_off string A formatted date.
delivery_date string A formatted date.
transit_time integer transit time
detailed_charges array of detailed charges Detailed Charges object
info_message string Info message of the rate result
error_message string Error message of the rate result

Service Option - Insurance

Insurance Service Option object

NameTypeDescription
type * string Accepts: insurance.
insured_value * money money object

Service Option - Pickup

Pickup Service Option object

NameTypeDescription
type * string Accepts: pickup.
start_time * string Preferred start of time period for pickup in HH:MM:SS
end_time string Preferred end of time period for pickup in HH:MM:SS

Ship From Address

Address object

NameTypeDescription
country * string Country in ISO 3166-1 alpha 3 code Accepts: ABW,AFG,AGO,AIA,ALA,ALB,AND,ANT,ARE,ARG,ARM,ASM,ATA,ATF,ATG,AUS,AUT,AZE,BDI,BEL,BEN,BES,BFA,BGD,BGR,BHR,BHS,BIH,BLM,BLR,BLZ,BMU,BOL,BRA,BRB,BRN,BTN,BVT,BWA,CAF,CAN,CCK,CHE,CHL,CHN,CIV,CMR,COD,COG,COK,COL,COM,CPV,CRI,CUB,CUW,CXR,CYM,CYP,CZE,DEU,DJI,DMA,DNK,DOM,DZA,ECU,EGY,ERI,ESH,ESP,EST,ETH,FIN,FJI,FLK,FRA,FRO,FSM,GAB,GBR,GEO,GGY,GHA,GIB,GIN,GLP,GMB,GNB,GNQ,GRC,GRD,GRL,GTM,GUF,GUM,GUY,HKG,HMD,HND,HRV,HTI,HUN,IDN,IMN,IND,IOT,IRL,IRN,IRQ,ISL,ISR,ITA,JAM,JEY,JOR,JPN,KAZ,KEN,KGZ,KHM,KIR,KNA,KOR,KWT,LAO,LBN,LBR,LBY,LCA,LIE,LKA,LSO,LTU,LUX,LVA,MAC,MAF,MAR,MCO,MDA,MDG,MDV,MEX,MHL,MKD,MLI,MLT,MMR,MNE,MNG,MNP,MOZ,MRT,MSR,MTQ,MUS,MWI,MYS,MYT,NAM,NCL,NER,NFK,NGA,NIC,NIU,NLD,NOR,NPL,NRU,NZL,OMN,PAK,PAN,PCN,PER,PHL,PLW,PNG,POL,PRI,PRK,PRT,PRY,PSE,PYF,QAT,REU,ROU,RUS,RWA,SAU,SDN,SEN,SGP,SGS,SHN,SJM,SLB,SLE,SLV,SMR,SOM,SPM,SRB,SSD,STP,SUR,SVK,SVN,SWE,SWZ,SXM,SYC,SYR,TCA,TCD,TGO,THA,TJK,TKL,TKM,TLS,TON,TTO,TUN,TUR,TUV,TWN,TZA,UGA,UKR,UMI,UNK,URY,USA,UZB,VAT,VCT,VEN,VGB,VIR,VNM,VUT,WLF,WSM,YEM,ZAF,ZMB,ZWE.
contact_name string contact_name of address
phone string contact_phone of address
fax string fax_number of address
email string email of address
company_name string company_name of address
street1 string address_line1 of address
street2 string address_line2 of address
street3 string address_line3 of address
city string city of address
state string state of address
postal_code string postal_code of address
type string type of address Accepts: business,residential.
tax_id string tax id

Ship To Address

Address object

NameTypeDescription
country * string Country in ISO 3166-1 alpha 3 code Accepts: ABW,AFG,AGO,AIA,ALA,ALB,AND,ANT,ARE,ARG,ARM,ASM,ATA,ATF,ATG,AUS,AUT,AZE,BDI,BEL,BEN,BES,BFA,BGD,BGR,BHR,BHS,BIH,BLM,BLR,BLZ,BMU,BOL,BRA,BRB,BRN,BTN,BVT,BWA,CAF,CAN,CCK,CHE,CHL,CHN,CIV,CMR,COD,COG,COK,COL,COM,CPV,CRI,CUB,CUW,CXR,CYM,CYP,CZE,DEU,DJI,DMA,DNK,DOM,DZA,ECU,EGY,ERI,ESH,ESP,EST,ETH,FIN,FJI,FLK,FRA,FRO,FSM,GAB,GBR,GEO,GGY,GHA,GIB,GIN,GLP,GMB,GNB,GNQ,GRC,GRD,GRL,GTM,GUF,GUM,GUY,HKG,HMD,HND,HRV,HTI,HUN,IDN,IMN,IND,IOT,IRL,IRN,IRQ,ISL,ISR,ITA,JAM,JEY,JOR,JPN,KAZ,KEN,KGZ,KHM,KIR,KNA,KOR,KWT,LAO,LBN,LBR,LBY,LCA,LIE,LKA,LSO,LTU,LUX,LVA,MAC,MAF,MAR,MCO,MDA,MDG,MDV,MEX,MHL,MKD,MLI,MLT,MMR,MNE,MNG,MNP,MOZ,MRT,MSR,MTQ,MUS,MWI,MYS,MYT,NAM,NCL,NER,NFK,NGA,NIC,NIU,NLD,NOR,NPL,NRU,NZL,OMN,PAK,PAN,PCN,PER,PHL,PLW,PNG,POL,PRI,PRK,PRT,PRY,PSE,PYF,QAT,REU,ROU,RUS,RWA,SAU,SDN,SEN,SGP,SGS,SHN,SJM,SLB,SLE,SLV,SMR,SOM,SPM,SRB,SSD,STP,SUR,SVK,SVN,SWE,SWZ,SXM,SYC,SYR,TCA,TCD,TGO,THA,TJK,TKL,TKM,TLS,TON,TTO,TUN,TUR,TUV,TWN,TZA,UGA,UKR,UMI,UNK,URY,USA,UZB,VAT,VCT,VEN,VGB,VIR,VNM,VUT,WLF,WSM,YEM,ZAF,ZMB,ZWE.
contact_name string contact_name of address
phone string contact_phone of address
fax string fax_number of address
email string email of address
company_name string company_name of address
street1 string address_line1 of address
street2 string address_line2 of address
street3 string address_line3 of address
city string city of address
state string state of address
postal_code string postal_code of address
type string type of address Accepts: business,residential.
tax_id string tax id

Shipper Account Credentials

Shipper Account Credentials

NameTypeDescription
partner_id * string
partner_token * string
aes_key * string
hmac_sha512_key * string
account_number string
origin_code string

Shipper Account Information

Shipper Account (brief information for rate and manifest responses)

NameTypeDescription
id * string Shipper Account ID
slug * string Courier Slug Accepts: sf-express-isp.
description string Shipper Account Description

Signature

Signature object

NameTypeDescription
id string id of referring object

Weight

weight object

NameTypeDescription
unit * string weight unit Accepts: lb,kg,oz,g.
value * number weight value

aes

EEI Type - aes

NameTypeDescription
type * string Accepts: aes.
itn_number * string ITN Number

no_eei

EEI Type - no_eei

NameTypeDescription
type * string Accepts: no_eei.
ftr_exemption * string Accepts: noeei_30_37_a,noeei_30_37_h,noeei_30_36.

reference

Object reference

NameTypeDescription
id * string id of referring object

return To Address

Address object

NameTypeDescription
country * string Country in ISO 3166-1 alpha 3 code Accepts: ABW,AFG,AGO,AIA,ALA,ALB,AND,ANT,ARE,ARG,ARM,ASM,ATA,ATF,ATG,AUS,AUT,AZE,BDI,BEL,BEN,BES,BFA,BGD,BGR,BHR,BHS,BIH,BLM,BLR,BLZ,BMU,BOL,BRA,BRB,BRN,BTN,BVT,BWA,CAF,CAN,CCK,CHE,CHL,CHN,CIV,CMR,COD,COG,COK,COL,COM,CPV,CRI,CUB,CUW,CXR,CYM,CYP,CZE,DEU,DJI,DMA,DNK,DOM,DZA,ECU,EGY,ERI,ESH,ESP,EST,ETH,FIN,FJI,FLK,FRA,FRO,FSM,GAB,GBR,GEO,GGY,GHA,GIB,GIN,GLP,GMB,GNB,GNQ,GRC,GRD,GRL,GTM,GUF,GUM,GUY,HKG,HMD,HND,HRV,HTI,HUN,IDN,IMN,IND,IOT,IRL,IRN,IRQ,ISL,ISR,ITA,JAM,JEY,JOR,JPN,KAZ,KEN,KGZ,KHM,KIR,KNA,KOR,KWT,LAO,LBN,LBR,LBY,LCA,LIE,LKA,LSO,LTU,LUX,LVA,MAC,MAF,MAR,MCO,MDA,MDG,MDV,MEX,MHL,MKD,MLI,MLT,MMR,MNE,MNG,MNP,MOZ,MRT,MSR,MTQ,MUS,MWI,MYS,MYT,NAM,NCL,NER,NFK,NGA,NIC,NIU,NLD,NOR,NPL,NRU,NZL,OMN,PAK,PAN,PCN,PER,PHL,PLW,PNG,POL,PRI,PRK,PRT,PRY,PSE,PYF,QAT,REU,ROU,RUS,RWA,SAU,SDN,SEN,SGP,SGS,SHN,SJM,SLB,SLE,SLV,SMR,SOM,SPM,SRB,SSD,STP,SUR,SVK,SVN,SWE,SWZ,SXM,SYC,SYR,TCA,TCD,TGO,THA,TJK,TKL,TKM,TLS,TON,TTO,TUN,TUR,TUV,TWN,TZA,UGA,UKR,UMI,UNK,URY,USA,UZB,VAT,VCT,VEN,VGB,VIR,VNM,VUT,WLF,WSM,YEM,ZAF,ZMB,ZWE.
contact_name string contact_name of address
phone string contact_phone of address
fax string fax_number of address
email string email of address
company_name string company_name of address
street1 string address_line1 of address
street2 string address_line2 of address
street3 string address_line3 of address
city string city of address
state string state of address
postal_code string postal_code of address
type string type of address Accepts: business,residential.
tax_id string tax id

address validation supported country Code

Country in ISO 3166-1 alpha 3 code

Accepts:
USA.

Box Type

Type of box for packaging

Accepts:
custom.

Bulk Download Status

Bulk Download Status

Accepts:
creating,created,failed.

Currency Code

Currency in ISO 4217 code

Accepts:
AED,AFN,ALL,AMD,ANG,AOA,ARS,AUD,AWG,AZN,BAM,BBD,BDT,BGN,BHD,BIF,BMD,BND,BOB,BOV,BRL,BSD,BTN,BWP,BYR,BZD,CAD,CDF,CHE,CHF,CHW,CLF,CLP,CNY,COP,COU,CRC,CUC,CUP,CVE,CZK,DJF,DKK,DOP,DZD,EGP,ERN,ETB,EUR,FJD,FKP,GBP,GEL,GHS,GIP,GMD,GNF,GTQ,GYD,HKD,HNL,HRK,HTG,HUF,IDR,ILS,INR,IQD,IRR,ISK,JMD,JOD,JPY,KES,KGS,KHR,KMF,KPW,KRW,KWD,KYD,KZT,LAK,LBP,LKR,LRD,LSL,LTL,LVL,LYD,MAD,MDL,MGA,MKD,MMK,MNT,MOP,MRO,MUR,MVR,MWK,MXN,MXV,MYR,MZN,NAD,NGN,NIO,NOK,NPR,NZD,OMR,PAB,PEN,PGK,PHP,PKR,PLN,PYG,QAR,RON,RSD,RUB,RWF,SAR,SBD,SCR,SDG,SEK,SGD,SHP,SLL,SOS,SRD,SSP,STD,SYP,SZL,THB,TJS,TMT,TND,TOP,TRY,TTD,TWD,TZS,UAH,UGX,USD,USN,USS,UYI,UYU,UZS,VEF,VND,VUV,WST,XAF,XAG,XAU,XBA,XBB,XBC,XBD,XCD,XDR,XFU,XOF,XPD,XPF,XPT,XTS,XXX,YER,ZAR,ZMW.

Country Code

Country in ISO 3166-1 alpha 3 code

Accepts:
ABW,AFG,AGO,AIA,ALA,ALB,AND,ANT,ARE,ARG,ARM,ASM,ATA,ATF,ATG,AUS,AUT,AZE,BDI,BEL,BEN,BES,BFA,BGD,BGR,BHR,BHS,BIH,BLM,BLR,BLZ,BMU,BOL,BRA,BRB,BRN,BTN,BVT,BWA,CAF,CAN,CCK,CHE,CHL,CHN,CIV,CMR,COD,COG,COK,COL,COM,CPV,CRI,CUB,CUW,CXR,CYM,CYP,CZE,DEU,DJI,DMA,DNK,DOM,DZA,ECU,EGY,ERI,ESH,ESP,EST,ETH,FIN,FJI,FLK,FRA,FRO,FSM,GAB,GBR,GEO,GGY,GHA,GIB,GIN,GLP,GMB,GNB,GNQ,GRC,GRD,GRL,GTM,GUF,GUM,GUY,HKG,HMD,HND,HRV,HTI,HUN,IDN,IMN,IND,IOT,IRL,IRN,IRQ,ISL,ISR,ITA,JAM,JEY,JOR,JPN,KAZ,KEN,KGZ,KHM,KIR,KNA,KOR,KWT,LAO,LBN,LBR,LBY,LCA,LIE,LKA,LSO,LTU,LUX,LVA,MAC,MAF,MAR,MCO,MDA,MDG,MDV,MEX,MHL,MKD,MLI,MLT,MMR,MNE,MNG,MNP,MOZ,MRT,MSR,MTQ,MUS,MWI,MYS,MYT,NAM,NCL,NER,NFK,NGA,NIC,NIU,NLD,NOR,NPL,NRU,NZL,OMN,PAK,PAN,PCN,PER,PHL,PLW,PNG,POL,PRI,PRK,PRT,PRY,PSE,PYF,QAT,REU,ROU,RUS,RWA,SAU,SDN,SEN,SGP,SGS,SHN,SJM,SLB,SLE,SLV,SMR,SOM,SPM,SRB,SSD,STP,SUR,SVK,SVN,SWE,SWZ,SXM,SYC,SYR,TCA,TCD,TGO,THA,TJK,TKL,TKM,TLS,TON,TTO,TUN,TUR,TUV,TWN,TZA,UGA,UKR,UMI,UNK,URY,USA,UZB,VAT,VCT,VEN,VGB,VIR,VNM,VUT,WLF,WSM,YEM,ZAF,ZMB,ZWE.

Label File Type

Label file type

Accepts:
pdf.

Label Paper Size

Label Paper Size

Accepts:
default.

A manifest file object

Postmen order id

Unique identification of the order.

Min length:
1
Max length:
50

Postmen Date

A formatted date.

Accepted formats:
YYYY-MM-DDTHH:mm:ss.SSSZ YYYY-MM-DDTHH:mm:ssZ YYYY-MM-DDTHH:mm:ss YYYY-MM-DDTHH:mmZ YYYY-MM-DDTHH:mm YYYY-MM-DD HH:mm:ss HH:mm

Postmen float

A float number.

Postmen integer

Postmen order number

A user-defined order number used to identify an order.

Min length:
1
Max length:
50

Postmen string

A string with a maximum length of 255 characters.

Min length:
1
Max length:
255

Label References

Reference numbers for a label

Service Option General Type

Service Option General Type

Accepts:
saturday_delivery,paperless_invoice,rural_delivery,sameday_evening_delivery,overnight_evening_delivery.

Postmen status

Status of Task

Accepts:
pending,success,failed,complete.

Service Type

Service Types

Accepts:
sf-express-isp_america_direct_ship,sf-express-isp_cloud_warehouse_next_day_delivery,sf-express-isp_cloud_warehouse_third_day_delivery,sf-express-isp_ecommerce_economy_express,sf-express-isp_ecommerce_express,sf-express-isp_ecommerce_special_delivery,sf-express-isp_economy_express,sf-express-isp_international_ecommerce_special_delivery,sf-express-isp_international_economy_express_document,sf-express-isp_international_economy_express_merchant_agent,sf-express-isp_international_economy_express_parcel,sf-express-isp_international_economy_express_pilot,sf-express-isp_international_heavy_freight,sf-express-isp_international_small_parcel,sf-express-isp_international_standard_express_document,sf-express-isp_international_standard_express_parcel,sf-express-isp_next_morning_delivery,sf-express-isp_register_mail,sf-express-isp_same_day_delivery,sf-express-isp_standard_express.

Ship date

Ship Date in YYYY-MM-DD, if not provided, will be today of the shipper account timezone

Accepted formats:
YYYY-MM-DD

Shipper Account Settings

Shipper Account Settings

Courier Slug

Courier Slug

Accepts:
sf-express-isp.

Timezone

Use IANA — Time Zone Database

Accepts:
Africa/Abidjan,Africa/Accra,Africa/Addis_Ababa,Africa/Algiers,Africa/Asmara,Africa/Asmera,Africa/Bamako,Africa/Bangui,Africa/Banjul,Africa/Bissau,Africa/Blantyre,Africa/Brazzaville,Africa/Bujumbura,Africa/Cairo,Africa/Casablanca,Africa/Ceuta,Africa/Conakry,Africa/Dakar,Africa/Dar_es_Salaam,Africa/Djibouti,Africa/Douala,Africa/El_Aaiun,Africa/Freetown,Africa/Gaborone,Africa/Harare,Africa/Johannesburg,Africa/Juba,Africa/Kampala,Africa/Khartoum,Africa/Kigali,Africa/Kinshasa,Africa/Lagos,Africa/Libreville,Africa/Lome,Africa/Luanda,Africa/Lubumbashi,Africa/Lusaka,Africa/Malabo,Africa/Maputo,Africa/Maseru,Africa/Mbabane,Africa/Mogadishu,Africa/Monrovia,Africa/Nairobi,Africa/Ndjamena,Africa/Niamey,Africa/Nouakchott,Africa/Ouagadougou,Africa/Porto-Novo,Africa/Sao_Tome,Africa/Timbuktu,Africa/Tripoli,Africa/Tunis,Africa/Windhoek,America/Adak,America/Anchorage,America/Anguilla,America/Antigua,America/Araguaina,America/Argentina/Buenos_Aires,America/Argentina/Catamarca,America/Argentina/ComodRivadavia,America/Argentina/Cordoba,America/Argentina/Jujuy,America/Argentina/La_Rioja,America/Argentina/Mendoza,America/Argentina/Rio_Gallegos,America/Argentina/Salta,America/Argentina/San_Juan,America/Argentina/San_Luis,America/Argentina/Tucuman,America/Argentina/Ushuaia,America/Aruba,America/Asuncion,America/Atikokan,America/Atka,America/Bahia,America/Bahia_Banderas,America/Barbados,America/Belem,America/Belize,America/Blanc-Sablon,America/Boa_Vista,America/Bogota,America/Boise,America/Buenos_Aires,America/Cambridge_Bay,America/Campo_Grande,America/Cancun,America/Caracas,America/Catamarca,America/Cayenne,America/Cayman,America/Chicago,America/Chihuahua,America/Coral_Harbour,America/Cordoba,America/Costa_Rica,America/Creston,America/Cuiaba,America/Curacao,America/Danmarkshavn,America/Dawson,America/Dawson_Creek,America/Denver,America/Detroit,America/Dominica,America/Edmonton,America/Eirunepe,America/El_Salvador,America/Ensenada,America/Fort_Nelson,America/Fort_Wayne,America/Fortaleza,America/Glace_Bay,America/Godthab,America/Goose_Bay,America/Grand_Turk,America/Grenada,America/Guadeloupe,America/Guatemala,America/Guayaquil,America/Guyana,America/Halifax,America/Havana,America/Hermosillo,America/Indiana/Indianapolis,America/Indiana/Knox,America/Indiana/Marengo,America/Indiana/Petersburg,America/Indiana/Tell_City,America/Indiana/Vevay,America/Indiana/Vincennes,America/Indiana/Winamac,America/Indianapolis,America/Inuvik,America/Iqaluit,America/Jamaica,America/Jujuy,America/Juneau,America/Kentucky/Louisville,America/Kentucky/Monticello,America/Knox_IN,America/Kralendijk,America/La_Paz,America/Lima,America/Los_Angeles,America/Louisville,America/Lower_Princes,America/Maceio,America/Managua,America/Manaus,America/Marigot,America/Martinique,America/Matamoros,America/Mazatlan,America/Mendoza,America/Menominee,America/Merida,America/Metlakatla,America/Mexico_City,America/Miquelon,America/Moncton,America/Monterrey,America/Montevideo,America/Montreal,America/Montserrat,America/Nassau,America/New_York,America/Nipigon,America/Nome,America/Noronha,America/North_Dakota/Beulah,America/North_Dakota/Center,America/North_Dakota/New_Salem,America/Ojinaga,America/Panama,America/Pangnirtung,America/Paramaribo,America/Phoenix,America/Port-au-Prince,America/Port_of_Spain,America/Porto_Acre,America/Porto_Velho,America/Puerto_Rico,America/Punta_Arenas,America/Rainy_River,America/Rankin_Inlet,America/Recife,America/Regina,America/Resolute,America/Rio_Branco,America/Rosario,America/Santa_Isabel,America/Santarem,America/Santiago,America/Santo_Domingo,America/Sao_Paulo,America/Scoresbysund,America/Shiprock,America/Sitka,America/St_Barthelemy,America/St_Johns,America/St_Kitts,America/St_Lucia,America/St_Thomas,America/St_Vincent,America/Swift_Current,America/Tegucigalpa,America/Thule,America/Thunder_Bay,America/Tijuana,America/Toronto,America/Tortola,America/Vancouver,America/Virgin,America/Whitehorse,America/Winnipeg,America/Yakutat,America/Yellowknife,Antarctica/Casey,Antarctica/Davis,Antarctica/DumontDUrville,Antarctica/Macquarie,Antarctica/Mawson,Antarctica/McMurdo,Antarctica/Palmer,Antarctica/Rothera,Antarctica/South_Pole,Antarctica/Syowa,Antarctica/Troll,Antarctica/Vostok,Arctic/Longyearbyen,Asia/Aden,Asia/Almaty,Asia/Amman,Asia/Anadyr,Asia/Aqtau,Asia/Aqtobe,Asia/Ashgabat,Asia/Ashkhabad,Asia/Atyrau,Asia/Baghdad,Asia/Bahrain,Asia/Baku,Asia/Bangkok,Asia/Barnaul,Asia/Beirut,Asia/Bishkek,Asia/Brunei,Asia/Calcutta,Asia/Chita,Asia/Choibalsan,Asia/Chongqing,Asia/Chungking,Asia/Colombo,Asia/Dacca,Asia/Damascus,Asia/Dhaka,Asia/Dili,Asia/Dubai,Asia/Dushanbe,Asia/Famagusta,Asia/Gaza,Asia/Harbin,Asia/Hebron,Asia/Ho_Chi_Minh,Asia/Hong_Kong,Asia/Hovd,Asia/Irkutsk,Asia/Istanbul,Asia/Jakarta,Asia/Jayapura,Asia/Jerusalem,Asia/Kabul,Asia/Kamchatka,Asia/Karachi,Asia/Kashgar,Asia/Kathmandu,Asia/Katmandu,Asia/Khandyga,Asia/Kolkata,Asia/Krasnoyarsk,Asia/Kuala_Lumpur,Asia/Kuching,Asia/Kuwait,Asia/Macao,Asia/Macau,Asia/Magadan,Asia/Makassar,Asia/Manila,Asia/Muscat,Asia/Nicosia,Asia/Novokuznetsk,Asia/Novosibirsk,Asia/Omsk,Asia/Oral,Asia/Phnom_Penh,Asia/Pontianak,Asia/Pyongyang,Asia/Qatar,Asia/Qyzylorda,Asia/Rangoon,Asia/Riyadh,Asia/Saigon,Asia/Sakhalin,Asia/Samarkand,Asia/Seoul,Asia/Shanghai,Asia/Singapore,Asia/Srednekolymsk,Asia/Taipei,Asia/Tashkent,Asia/Tbilisi,Asia/Tehran,Asia/Tel_Aviv,Asia/Thimbu,Asia/Thimphu,Asia/Tokyo,Asia/Tomsk,Asia/Ujung_Pandang,Asia/Ulaanbaatar,Asia/Ulan_Bator,Asia/Urumqi,Asia/Ust-Nera,Asia/Vientiane,Asia/Vladivostok,Asia/Yakutsk,Asia/Yangon,Asia/Yekaterinburg,Asia/Yerevan,Atlantic/Azores,Atlantic/Bermuda,Atlantic/Canary,Atlantic/Cape_Verde,Atlantic/Faeroe,Atlantic/Faroe,Atlantic/Jan_Mayen,Atlantic/Madeira,Atlantic/Reykjavik,Atlantic/South_Georgia,Atlantic/St_Helena,Atlantic/Stanley,Australia/ACT,Australia/Adelaide,Australia/Brisbane,Australia/Broken_Hill,Australia/Canberra,Australia/Currie,Australia/Darwin,Australia/Eucla,Australia/Hobart,Australia/LHI,Australia/Lindeman,Australia/Lord_Howe,Australia/Melbourne,Australia/NSW,Australia/North,Australia/Perth,Australia/Queensland,Australia/South,Australia/Sydney,Australia/Tasmania,Australia/Victoria,Australia/West,Australia/Yancowinna,Brazil/Acre,Brazil/DeNoronha,Brazil/East,Brazil/West,Canada/Atlantic,Canada/Central,Canada/East-Saskatchewan,Canada/Eastern,Canada/Mountain,Canada/Newfoundland,Canada/Pacific,Canada/Saskatchewan,Canada/Yukon,Chile/Continental,Chile/EasterIsland,Europe/Amsterdam,Europe/Andorra,Europe/Astrakhan,Europe/Athens,Europe/Belfast,Europe/Belgrade,Europe/Berlin,Europe/Bratislava,Europe/Brussels,Europe/Bucharest,Europe/Budapest,Europe/Busingen,Europe/Chisinau,Europe/Copenhagen,Europe/Dublin,Europe/Gibraltar,Europe/Guernsey,Europe/Helsinki,Europe/Isle_of_Man,Europe/Istanbul,Europe/Jersey,Europe/Kaliningrad,Europe/Kiev,Europe/Kirov,Europe/Lisbon,Europe/Ljubljana,Europe/London,Europe/Luxembourg,Europe/Madrid,Europe/Malta,Europe/Mariehamn,Europe/Minsk,Europe/Monaco,Europe/Moscow,Europe/Nicosia,Europe/Oslo,Europe/Paris,Europe/Podgorica,Europe/Prague,Europe/Riga,Europe/Rome,Europe/Samara,Europe/San_Marino,Europe/Sarajevo,Europe/Saratov,Europe/Simferopol,Europe/Skopje,Europe/Sofia,Europe/Stockholm,Europe/Tallinn,Europe/Tirane,Europe/Tiraspol,Europe/Ulyanovsk,Europe/Uzhgorod,Europe/Vaduz,Europe/Vatican,Europe/Vienna,Europe/Vilnius,Europe/Volgograd,Europe/Warsaw,Europe/Zagreb,Europe/Zaporozhye,Europe/Zurich,Indian/Antananarivo,Indian/Chagos,Indian/Christmas,Indian/Cocos,Indian/Comoro,Indian/Kerguelen,Indian/Mahe,Indian/Maldives,Indian/Mauritius,Indian/Mayotte,Indian/Reunion,Mexico/BajaNorte,Mexico/BajaSur,Mexico/General,Pacific/Apia,Pacific/Auckland,Pacific/Bougainville,Pacific/Chatham,Pacific/Chuuk,Pacific/Easter,Pacific/Efate,Pacific/Enderbury,Pacific/Fakaofo,Pacific/Fiji,Pacific/Funafuti,Pacific/Galapagos,Pacific/Gambier,Pacific/Guadalcanal,Pacific/Guam,Pacific/Honolulu,Pacific/Johnston,Pacific/Kiritimati,Pacific/Kosrae,Pacific/Kwajalein,Pacific/Majuro,Pacific/Marquesas,Pacific/Midway,Pacific/Nauru,Pacific/Niue,Pacific/Norfolk,Pacific/Noumea,Pacific/Pago_Pago,Pacific/Palau,Pacific/Pitcairn,Pacific/Pohnpei,Pacific/Ponape,Pacific/Port_Moresby,Pacific/Rarotonga,Pacific/Saipan,Pacific/Samoa,Pacific/Tahiti,Pacific/Tarawa,Pacific/Tongatapu,Pacific/Truk,Pacific/Wake,Pacific/Wallis,Pacific/Yap,US/Alaska,US/Aleutian,US/Arizona,US/Central,US/East-Indiana,US/Eastern,US/Hawaii,US/Indiana-Starke,US/Michigan,US/Mountain,US/Pacific,US/Pacific-New,US/Samoa,UTC.