Postmen API docs for Colissimo

Labels

Labels

POST Create a label

Try it 
/labels

Create a label

NameTypeDescription
service_type * string Service Types Accepts: colissimo_return_france.
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,a4,4x6. (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 - general or 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,
	  "is_document": false,
	  "service_type": "colissimo_return_france",
	  "paper_size": "default",
	  "file_type": "pdf",
	  "shipper_account": {
	    "id": "87e21243-5758-483f-bbae-000000000000"
	  },
	  "references": [
	    "1234567890"
	  ],
	  "shipment": {
	    "parcels": [
	      {
	        "description": "adidas Yeezy - 40",
	        "box_type": "custom",
	        "weight": {
	          "value": 1.6,
	          "unit": "kg"
	        },
	        "dimension": {
	          "height": 28,
	          "width": 26,
	          "depth": 38,
	          "unit": "cm"
	        },
	        "items": [
	          {
	            "description": "adidas Yeezy  - 40",
	            "item_id": "10027107287219",
	            "quantity": 1,
	            "price": {
	              "amount": 184.79,
	              "currency": "EUR"
	            },
	            "weight": {
	              "value": 0.8,
	              "unit": "kg"
	            },
	            "sku": "GW2871SP40",
	            "origin_country": "CHN",
	            "hs_code": "640520"
	          }
	        ]
	      }
	    ],
	    "ship_from": {
	      "city": "Paris",
	      "company_name": null,
	      "contact_name": "test contact name",
	      "country": "FRA",
	      "email": "sender@test.com",
	      "phone": null,
	      "postal_code": "75007",
	      "state": null,
	      "street1": "mon adresse",
	      "street2": "line1",
	      "street3": null,
	      "tax_id": null,
	      "type": null
	    },
	    "ship_to": {
	      "city": "Paris",
	      "company_name": null,
	      "contact_name": "test contact name",
	      "country": "FRA",
	      "phone": null,
	      "postal_code": "75015",
	      "state": null,
	      "street1": "mon adresse",
	      "street2": "line1",
	      "street3": null,
	      "tax_id": null,
	      "eori_number": null
	    }
	  },
	  "service_options": [
	    {
	      "type": "insurance",
	      "insured_value": {
	        "amount": 184.79,
	        "currency": "EUR"
	      }
	    }
	  ]
	}
	

	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,"is_document":false,"service_type":"colissimo_return_france","paper_size":"default","file_type":"pdf","shipper_account":{"id":"87e21243-5758-483f-bbae-000000000000"},"references":["1234567890"],"shipment":{"parcels":[{"description":"adidas Yeezy - 40","box_type":"custom","weight":{"value":1.6,"unit":"kg"},"dimension":{"height":28,"width":26,"depth":38,"unit":"cm"},"items":[{"description":"adidas Yeezy  - 40","item_id":"10027107287219","quantity":1,"price":{"amount":184.79,"currency":"EUR"},"weight":{"value":0.8,"unit":"kg"},"sku":"GW2871SP40","origin_country":"CHN","hs_code":"640520"}]}],"ship_from":{"city":"Paris","company_name":null,"contact_name":"test contact name","country":"FRA","email":"sender@test.com","phone":null,"postal_code":"75007","state":null,"street1":"mon adresse","street2":"line1","street3":null,"tax_id":null,"type":null},"ship_to":{"city":"Paris","company_name":null,"contact_name":"test contact name","country":"FRA","phone":null,"postal_code":"75015","state":null,"street1":"mon adresse","street2":"line1","street3":null,"tax_id":null,"eori_number":null}},"service_options":[{"type":"insurance","insured_value":{"amount":184.79,"currency":"EUR"}}]}'
	

	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,\"is_document\":false,\"service_type\":\"colissimo_return_france\",\"paper_size\":\"default\",\"file_type\":\"pdf\",\"shipper_account\":{\"id\":\"87e21243-5758-483f-bbae-000000000000\"},\"references\":[\"1234567890\"],\"shipment\":{\"parcels\":[{\"description\":\"adidas Yeezy - 40\",\"box_type\":\"custom\",\"weight\":{\"value\":1.6,\"unit\":\"kg\"},\"dimension\":{\"height\":28,\"width\":26,\"depth\":38,\"unit\":\"cm\"},\"items\":[{\"description\":\"adidas Yeezy  - 40\",\"item_id\":\"10027107287219\",\"quantity\":1,\"price\":{\"amount\":184.79,\"currency\":\"EUR\"},\"weight\":{\"value\":0.8,\"unit\":\"kg\"},\"sku\":\"GW2871SP40\",\"origin_country\":\"CHN\",\"hs_code\":\"640520\"}]}],\"ship_from\":{\"city\":\"Paris\",\"company_name\":null,\"contact_name\":\"test contact name\",\"country\":\"FRA\",\"email\":\"sender@test.com\",\"phone\":null,\"postal_code\":\"75007\",\"state\":null,\"street1\":\"mon adresse\",\"street2\":\"line1\",\"street3\":null,\"tax_id\":null,\"type\":null},\"ship_to\":{\"city\":\"Paris\",\"company_name\":null,\"contact_name\":\"test contact name\",\"country\":\"FRA\",\"phone\":null,\"postal_code\":\"75015\",\"state\":null,\"street1\":\"mon adresse\",\"street2\":\"line1\",\"street3\":null,\"tax_id\":null,\"eori_number\":null}},\"service_options\":[{\"type\":\"insurance\",\"insured_value\":{\"amount\":184.79,\"currency\":\"EUR\"}}]}";
	
	        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,\"is_document\":false,\"service_type\":\"colissimo_return_france\",\"paper_size\":\"default\",\"file_type\":\"pdf\",\"shipper_account\":{\"id\":\"87e21243-5758-483f-bbae-000000000000\"},\"references\":[\"1234567890\"],\"shipment\":{\"parcels\":[{\"description\":\"adidas Yeezy - 40\",\"box_type\":\"custom\",\"weight\":{\"value\":1.6,\"unit\":\"kg\"},\"dimension\":{\"height\":28,\"width\":26,\"depth\":38,\"unit\":\"cm\"},\"items\":[{\"description\":\"adidas Yeezy  - 40\",\"item_id\":\"10027107287219\",\"quantity\":1,\"price\":{\"amount\":184.79,\"currency\":\"EUR\"},\"weight\":{\"value\":0.8,\"unit\":\"kg\"},\"sku\":\"GW2871SP40\",\"origin_country\":\"CHN\",\"hs_code\":\"640520\"}]}],\"ship_from\":{\"city\":\"Paris\",\"company_name\":null,\"contact_name\":\"test contact name\",\"country\":\"FRA\",\"email\":\"sender@test.com\",\"phone\":null,\"postal_code\":\"75007\",\"state\":null,\"street1\":\"mon adresse\",\"street2\":\"line1\",\"street3\":null,\"tax_id\":null,\"type\":null},\"ship_to\":{\"city\":\"Paris\",\"company_name\":null,\"contact_name\":\"test contact name\",\"country\":\"FRA\",\"phone\":null,\"postal_code\":\"75015\",\"state\":null,\"street1\":\"mon adresse\",\"street2\":\"line1\",\"street3\":null,\"tax_id\":null,\"eori_number\":null}},\"service_options\":[{\"type\":\"insurance\",\"insured_value\":{\"amount\":184.79,\"currency\":\"EUR\"}}]}");
	
	    	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,"is_document":false,"service_type":"colissimo_return_france","paper_size":"default","file_type":"pdf","shipper_account":{"id":"87e21243-5758-483f-bbae-000000000000"},"references":["1234567890"],"shipment":{"parcels":[{"description":"adidas Yeezy - 40","box_type":"custom","weight":{"value":1.6,"unit":"kg"},"dimension":{"height":28,"width":26,"depth":38,"unit":"cm"},"items":[{"description":"adidas Yeezy  - 40","item_id":"10027107287219","quantity":1,"price":{"amount":184.79,"currency":"EUR"},"weight":{"value":0.8,"unit":"kg"},"sku":"GW2871SP40","origin_country":"CHN","hs_code":"640520"}]}],"ship_from":{"city":"Paris","company_name":null,"contact_name":"test contact name","country":"FRA","email":"sender@test.com","phone":null,"postal_code":"75007","state":null,"street1":"mon adresse","street2":"line1","street3":null,"tax_id":null,"type":null},"ship_to":{"city":"Paris","company_name":null,"contact_name":"test contact name","country":"FRA","phone":null,"postal_code":"75015","state":null,"street1":"mon adresse","street2":"line1","street3":null,"tax_id":null,"eori_number":null}},"service_options":[{"type":"insurance","insured_value":{"amount":184.79,"currency":"EUR"}}]}'
	};
	
	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,"is_document":false,"service_type":"colissimo_return_france","paper_size":"default","file_type":"pdf","shipper_account":{"id":"87e21243-5758-483f-bbae-000000000000"},"references":["1234567890"],"shipment":{"parcels":[{"description":"adidas Yeezy - 40","box_type":"custom","weight":{"value":1.6,"unit":"kg"},"dimension":{"height":28,"width":26,"depth":38,"unit":"cm"},"items":[{"description":"adidas Yeezy  - 40","item_id":"10027107287219","quantity":1,"price":{"amount":184.79,"currency":"EUR"},"weight":{"value":0.8,"unit":"kg"},"sku":"GW2871SP40","origin_country":"CHN","hs_code":"640520"}]}],"ship_from":{"city":"Paris","company_name":null,"contact_name":"test contact name","country":"FRA","email":"sender@test.com","phone":null,"postal_code":"75007","state":null,"street1":"mon adresse","street2":"line1","street3":null,"tax_id":null,"type":null},"ship_to":{"city":"Paris","company_name":null,"contact_name":"test contact name","country":"FRA","phone":null,"postal_code":"75015","state":null,"street1":"mon adresse","street2":"line1","street3":null,"tax_id":null,"eori_number":null}},"service_options":[{"type":"insurance","insured_value":{"amount":184.79,"currency":"EUR"}}]}';
	
	    $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,
	  "is_document": false,
	  "service_type": "colissimo_return_france",
	  "paper_size": "default",
	  "file_type": "pdf",
	  "shipper_account": {
	    "id": "87e21243-5758-483f-bbae-000000000000"
	  },
	  "references": [
	    "1234567890"
	  ],
	  "shipment": {
	    "parcels": [
	      {
	        "description": "adidas Yeezy - 40",
	        "box_type": "custom",
	        "weight": {
	          "value": 1.6,
	          "unit": "kg"
	        },
	        "dimension": {
	          "height": 28,
	          "width": 26,
	          "depth": 38,
	          "unit": "cm"
	        },
	        "items": [
	          {
	            "description": "adidas Yeezy  - 40",
	            "item_id": "10027107287219",
	            "quantity": 1,
	            "price": {
	              "amount": 184.79,
	              "currency": "EUR"
	            },
	            "weight": {
	              "value": 0.8,
	              "unit": "kg"
	            },
	            "sku": "GW2871SP40",
	            "origin_country": "CHN",
	            "hs_code": "640520"
	          }
	        ]
	      }
	    ],
	    "ship_from": {
	      "city": "Paris",
	      "company_name": null,
	      "contact_name": "test contact name",
	      "country": "FRA",
	      "email": "sender@test.com",
	      "phone": null,
	      "postal_code": "75007",
	      "state": null,
	      "street1": "mon adresse",
	      "street2": "line1",
	      "street3": null,
	      "tax_id": null,
	      "type": null
	    },
	    "ship_to": {
	      "city": "Paris",
	      "company_name": null,
	      "contact_name": "test contact name",
	      "country": "FRA",
	      "phone": null,
	      "postal_code": "75015",
	      "state": null,
	      "street1": "mon adresse",
	      "street2": "line1",
	      "street3": null,
	      "tax_id": null,
	      "eori_number": null
	    }
	  },
	  "service_options": [
	    {
	      "type": "insurance",
	      "insured_value": {
	        "amount": 184.79,
	        "currency": "EUR"
	      }
	    }
	  ]
	}
	'''
	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,"is_document":false,"service_type":"colissimo_return_france","paper_size":"default","file_type":"pdf","shipper_account":{"id":"87e21243-5758-483f-bbae-000000000000"},"references":["1234567890"],"shipment":{"parcels":[{"description":"adidas Yeezy - 40","box_type":"custom","weight":{"value":1.6,"unit":"kg"},"dimension":{"height":28,"width":26,"depth":38,"unit":"cm"},"items":[{"description":"adidas Yeezy  - 40","item_id":"10027107287219","quantity":1,"price":{"amount":184.79,"currency":"EUR"},"weight":{"value":0.8,"unit":"kg"},"sku":"GW2871SP40","origin_country":"CHN","hs_code":"640520"}]}],"ship_from":{"city":"Paris","company_name":null,"contact_name":"test contact name","country":"FRA","email":"sender@test.com","phone":null,"postal_code":"75007","state":null,"street1":"mon adresse","street2":"line1","street3":null,"tax_id":null,"type":null},"ship_to":{"city":"Paris","company_name":null,"contact_name":"test contact name","country":"FRA","phone":null,"postal_code":"75015","state":null,"street1":"mon adresse","street2":"line1","street3":null,"tax_id":null,"eori_number":null}},"service_options":[{"type":"insurance","insured_value":{"amount":184.79,"currency":"EUR"}}]}'
	
	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: colissimo_return_france.
order_number string A user-defined order number used to identify an order.

Response example

{
	  "meta": {
	    "code": 200,
	    "message": "OK",
	    "details": []
	  },
	  "data": {
	    "id": "2c08c13d-e683-4386-952a-02f82bcaea7a",
	    "status": "created",
	    "ship_date": "2022-01-12",
	    "created_at": "2022-01-12T08:10:58+00:00",
	    "updated_at": "2022-01-12T08:11:02+00:00",
	    "tracking_numbers": [
	      "8R43600185999"
	    ],
	    "files": {
	      "label": {
	        "paper_size": "default",
	        "url": "https://development-sandbox-download.postmen.io/label/2022-01-12/000000000000000000000000000000000000.pdf",
	        "file_type": "pdf"
	      },
	      "qr_code": null,
	      "invoice": null,
	      "customs_declaration": null,
	      "manifest": null
	    },
	    "rate": {
	      "shipper_account": {
	        "id": "00000000-0000-0000-0000-892432954ed7",
	        "slug": "colissimo",
	        "description": "colissimo description"
	      },
	      "service_type": "colissimo_return_france",
	      "service_name": "Colissimo Return France",
	      "pickup_deadline": null,
	      "booking_cut_off": null,
	      "delivery_date": null,
	      "transit_time": null,
	      "error_message": null,
	      "info_message": "No rate quotes returned from carrier.",
	      "charge_weight": null,
	      "total_charge": null,
	      "detailed_charges": []
	    },
	    "references": [],
	    "service_type": "colissimo_return_france",
	    "shipper_account": {
	      "id": "00000000-0000-0000-0000-892432954ed7",
	      "slug": "colissimo"
	    }
	  }
	}

GET Retrieve a label

Try it 
/labels/:id

Retrieve a label


	{}
	

	curl --request GET \
	    --url https://sandbox-api.postmen.com/v3/labels/e068936f-b47b-4938-bd37-000000000000 \
	    --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/e068936f-b47b-4938-bd37-000000000000");
	
	        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/e068936f-b47b-4938-bd37-000000000000")
	            .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/e068936f-b47b-4938-bd37-000000000000',
	    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/e068936f-b47b-4938-bd37-000000000000';
	    $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/e068936f-b47b-4938-bd37-000000000000'
	
	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/e068936f-b47b-4938-bd37-000000000000')
	
	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

{
	  "meta": {
	    "code": 200,
	    "message": "OK",
	    "details": []
	  },
	  "data": {
	    "id": "2c08c13d-e683-4386-952a-02f82bcaea7a",
	    "status": "created",
	    "ship_date": "2022-01-12",
	    "created_at": "2022-01-12T08:10:58+00:00",
	    "updated_at": "2022-01-12T08:11:02+00:00",
	    "tracking_numbers": [
	      "8R43600185999"
	    ],
	    "files": {
	      "label": {
	        "paper_size": "default",
	        "url": "https://development-sandbox-download.postmen.io/label/2022-01-12/000000000000000000000000000000000000.pdf",
	        "file_type": "pdf"
	      },
	      "qr_code": null,
	      "invoice": null,
	      "customs_declaration": null,
	      "manifest": null
	    },
	    "rate": {
	      "shipper_account": {
	        "id": "00000000-0000-0000-0000-892432954ed7",
	        "slug": "colissimo",
	        "description": "colissimo description"
	      },
	      "service_type": "colissimo_return_france",
	      "service_name": "Colissimo Return France",
	      "pickup_deadline": null,
	      "booking_cut_off": null,
	      "delivery_date": null,
	      "transit_time": null,
	      "error_message": null,
	      "info_message": "No rate quotes returned from carrier.",
	      "charge_weight": null,
	      "total_charge": null,
	      "detailed_charges": []
	    },
	    "references": [],
	    "service_type": "colissimo_return_france",
	    "shipper_account": {
	      "id": "00000000-0000-0000-0000-892432954ed7",
	      "slug": "colissimo"
	    }
	  }
	}

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": 20,
	    "created_at_min": "2015-11-26T08:49:15+00:00",
	    "created_at_max": "2015-11-27T08:49:15+00:00",
	    "labels": [
	      {
	        "id": "2c08c13d-e683-4386-952a-02f82bcaea7a",
	        "status": "created",
	        "ship_date": "2021-12-03",
	        "created_at": "2021-12-03T08:10:58+00:00",
	        "updated_at": "2021-12-03T08:11:02+00:00",
	        "tracking_numbers": [
	          "XP443976765FR"
	        ],
	        "files": {
	          "label": {
	            "paper_size": "4x6",
	            "url": "https://development-sandbox-download.postmen.io/label/2021-12-03/000000000000000000000000000000000000.pdf",
	            "file_type": "pdf"
	          },
	          "qr_code": null,
	          "invoice": null,
	          "customs_declaration": null,
	          "manifest": null
	        },
	        "rate": {
	          "shipper_account": {
	            "id": "00000000-0000-0000-0000-892432954ed7",
	            "slug": "chronopost-france",
	            "description": "chronopost-france"
	          },
	          "service_type": "chronopost-france_13",
	          "service_name": "Chrono 13",
	          "pickup_deadline": null,
	          "booking_cut_off": null,
	          "delivery_date": null,
	          "transit_time": null,
	          "error_message": null,
	          "info_message": "No rate quotes returned from carrier.",
	          "charge_weight": null,
	          "total_charge": null,
	          "detailed_charges": []
	        },
	        "references": [],
	        "service_type": "chronopost-france_13",
	        "shipper_account": {
	          "id": "00000000-0000-0000-0000-892432954ed7",
	          "slug": "chronopost-france"
	        }
	      },
	      {
	        "id": "de57ca7e-0ca2-4bd9-8e25-cd9502dc66ed",
	        "status": "created",
	        "tracking_numbers": [
	          "8149526918288889"
	        ],
	        "files": {
	          "label": {
	            "paper_size": "4x6",
	            "url": "https://sandbox-download.postmen.com/label/2015-11-27/00000000-0000-0000-0000-000000000000-1441785264309885.pdf",
	            "file_type": "pdf"
	          },
	          "invoice": {
	            "paper_size": "a4",
	            "url": "https://sandbox-download.postmen.com/invoice/2015-11-27/00000000-0000-0000-0000-000000000000-1441785264309885.pdf",
	            "file_type": "pdf"
	          },
	          "customs_declaration": null,
	          "manifest": null
	        },
	        "rate": {
	          "charge_weight": {
	            "value": 2,
	            "unit": "kg"
	          },
	          "total_charge": null,
	          "shipper_account": {
	            "id": "00000000-0000-0000-0000-000000000000",
	            "slug": "hermes",
	            "description": "hermes (Runscope)"
	          },
	          "service_type": "hermes_standard",
	          "service_name": "Standard",
	          "pickup_deadline": null,
	          "booking_cut_off": null,
	          "delivery_date": null,
	          "transit_time": null,
	          "detailed_charges": [],
	          "error_message": null,
	          "info_message": "No rate quotes returned from carrier."
	        },
	        "created_at": "2015-11-27T08:47:20+00:00",
	        "updated_at": "2015-11-27T08:47:22+00:00"
	      },
	      {
	        "id": "72393fe3-be8e-4a7a-8434-1f0b5b56c09e",
	        "status": "cancelled",
	        "tracking_numbers": [
	          "0470110200793101997414"
	        ],
	        "files": {
	          "label": {
	            "paper_size": "4x6",
	            "url": "https://sandbox-download.postmen.com/label/2015-11-27/00000000-0000-0000-0000-000000000000-1441785264309885.pdf",
	            "file_type": "pdf"
	          },
	          "invoice": {
	            "paper_size": "a4",
	            "url": "https://sandbox-download.postmen.com/invoice/2015-11-27/00000000-0000-0000-0000-000000000000-1441785264309885.pdf",
	            "file_type": "pdf"
	          },
	          "customs_declaration": null,
	          "manifest": null
	        },
	        "rate": {
	          "charge_weight": null,
	          "total_charge": {
	            "amount": 16.3,
	            "currency": "USD"
	          },
	          "shipper_account": {
	            "id": "00000000-0000-0000-0000-000000000000",
	            "slug": "endicia",
	            "description": "endicia (Runscope)"
	          },
	          "service_type": "endicia_priority_mail_express",
	          "service_name": "Endicia Priority Mail Express",
	          "pickup_deadline": null,
	          "booking_cut_off": null,
	          "delivery_date": null,
	          "transit_time": 1,
	          "detailed_charges": [],
	          "error_message": null,
	          "info_message": null
	        },
	        "created_at": "2015-11-27T08:46:56+00:00",
	        "updated_at": "2015-11-27T08:47:02+00:00"
	      },
	      {
	        "id": "b69a27fc-a025-4d9b-a122-e009024d7a0c",
	        "status": "created",
	        "tracking_numbers": [
	          "0020165036"
	        ],
	        "files": {
	          "label": {
	            "paper_size": "4x8",
	            "url": "https://sandbox-download.postmen.com/label/2015-11-27/00000000-0000-0000-0000-000000000000-1441785264309885.pdf",
	            "file_type": "pdf"
	          },
	          "invoice": null,
	          "customs_declaration": null,
	          "manifest": null
	        },
	        "rate": {
	          "charge_weight": {
	            "value": 3.307,
	            "unit": "lb"
	          },
	          "total_charge": {
	            "amount": 0,
	            "currency": "USD"
	          },
	          "shipper_account": {
	            "id": "00000000-0000-0000-0000-000000000000",
	            "slug": "dhl",
	            "description": "dhl (Runscope)"
	          },
	          "service_type": "dhl_express_0900",
	          "service_name": "DHL Express 0900",
	          "pickup_deadline": null,
	          "booking_cut_off": null,
	          "delivery_date": null,
	          "transit_time": null,
	          "detailed_charges": [],
	          "error_message": null,
	          "info_message": null
	        },
	        "created_at": "2015-11-27T08:46:39+00:00",
	        "updated_at": "2015-11-27T08:46:43+00:00"
	      },
	      {
	        "id": "b8463988-114a-43ff-86f8-66451a20688c",
	        "status": "created",
	        "tracking_numbers": [],
	        "files": {
	          "label": {
	            "paper_size": "default",
	            "url": "https://sandbox-download.postmen.com/label/2015-11-27/00000000-0000-0000-0000-000000000000-1441785264309885.pdf",
	            "file_type": "pdf"
	          },
	          "invoice": null,
	          "customs_declaration": null,
	          "manifest": null
	        },
	        "rate": {
	          "charge_weight": {
	            "value": 9,
	            "unit": "lb"
	          },
	          "total_charge": {
	            "amount": 34.82,
	            "currency": "CAD"
	          },
	          "shipper_account": {
	            "id": "00000000-0000-0000-0000-000000000000",
	            "slug": "canpar",
	            "description": "canpar (Runscope)"
	          },
	          "service_type": "canpar_ground",
	          "service_name": "GROUND",
	          "pickup_deadline": null,
	          "booking_cut_off": null,
	          "delivery_date": "2015-12-02T05:00:00+00:00",
	          "transit_time": 3,
	          "detailed_charges": [
	            {
	              "type": "Freight Charge",
	              "charge": {
	                "amount": 30.41,
	                "currency": "CAD"
	              }
	            },
	            {
	              "type": "Residential Address Charge",
	              "charge": {
	                "amount": 2.75,
	                "currency": "CAD"
	              }
	            },
	            {
	              "type": "GST",
	              "charge": {
	                "amount": 1.66,
	                "currency": "CAD"
	              }
	            }
	          ],
	          "error_message": null,
	          "info_message": null
	        },
	        "created_at": "2015-11-27T08:44:54+00:00",
	        "updated_at": "2015-11-27T08:44:57+00:00"
	      },
	      {
	        "id": "97c1ce96-1a07-49d4-a4f6-5f5aa0fd2511",
	        "status": "created",
	        "tracking_numbers": [
	          "984190007700204439"
	        ],
	        "files": {
	          "label": {
	            "paper_size": "a4",
	            "url": "https://sandbox-download.postmen.com/label/2015-11-27/00000000-0000-0000-0000-000000000000-1441785264309885.pdf",
	            "file_type": "pdf"
	          },
	          "invoice": null,
	          "customs_declaration": null,
	          "manifest": null
	        },
	        "rate": {
	          "charge_weight": {
	            "value": 1.3,
	            "unit": "kg"
	          },
	          "total_charge": null,
	          "shipper_account": {
	            "id": "00000000-0000-0000-0000-000000000000",
	            "slug": "asendia-hk",
	            "description": "asendia-hk (Runscope)"
	          },
	          "service_type": "asendia-hk_reg",
	          "service_name": "Registered Mail",
	          "pickup_deadline": null,
	          "booking_cut_off": null,
	          "delivery_date": null,
	          "transit_time": null,
	          "detailed_charges": [],
	          "error_message": null,
	          "info_message": "No rate quotes returned from carrier."
	        },
	        "created_at": "2015-11-27T08:44:22+00:00",
	        "updated_at": "2015-11-27T08:44:23+00:00"
	      },
	      {
	        "id": "d2875fe7-b559-47ff-ae27-c0836aacc586",
	        "status": "created",
	        "tracking_numbers": [
	          "794666490930"
	        ],
	        "files": {
	          "label": {
	            "paper_size": "4x6",
	            "url": "https://sandbox-download.postmen.com/label/2015-11-27/00000000-0000-0000-0000-000000000000-1441785264309885.pdf",
	            "file_type": "pdf"
	          },
	          "invoice": {
	            "paper_size": "a4",
	            "url": "https://sandbox-download.postmen.com/invoice/2015-11-27/00000000-0000-0000-0000-000000000000-1441785264309885.pdf",
	            "file_type": "pdf"
	          },
	          "customs_declaration": null,
	          "manifest": null
	        },
	        "rate": {
	          "charge_weight": {
	            "value": 30,
	            "unit": "lb"
	          },
	          "total_charge": {
	            "amount": 13.56,
	            "currency": "USD"
	          },
	          "shipper_account": {
	            "id": "00000000-0000-0000-0000-000000000000",
	            "slug": "fedex",
	            "description": "fedex (Runscope)"
	          },
	          "service_type": "fedex_ground",
	          "service_name": "Fedex Ground",
	          "pickup_deadline": null,
	          "booking_cut_off": null,
	          "delivery_date": null,
	          "transit_time": null,
	          "detailed_charges": [
	            {
	              "type": "base",
	              "charge": {
	                "amount": 13.01,
	                "currency": "USD"
	              }
	            },
	            {
	              "type": "fedex_ground_fuel",
	              "charge": {
	                "amount": 0.55,
	                "currency": "USD"
	              }
	            }
	          ],
	          "error_message": null,
	          "info_message": null
	        },
	        "created_at": "2015-11-27T08:42:06+00:00",
	        "updated_at": "2015-11-27T08:42:10+00:00"
	      },
	      {
	        "id": "e6c8b70c-f367-4fd6-a6f1-5308aa8fd8a0",
	        "status": "created",
	        "tracking_numbers": [
	          "PREF10000000000148"
	        ],
	        "files": {
	          "label": {
	            "paper_size": "default",
	            "url": "https://sandbox-download.postmen.com/label/2015-11-27/00000000-0000-0000-0000-000000000000-1441785264309885.pdf",
	            "file_type": "pdf"
	          },
	          "invoice": null,
	          "customs_declaration": null,
	          "manifest": null
	        },
	        "rate": {
	          "charge_weight": {
	            "value": 9.54,
	            "unit": "kg"
	          },
	          "total_charge": null,
	          "shipper_account": {
	            "id": "00000000-0000-0000-0000-000000000000",
	            "slug": "spsr",
	            "description": "spsr (Runscope)"
	          },
	          "service_type": "spsr_gepintl",
	          "service_name": "GEPINTL",
	          "pickup_deadline": null,
	          "booking_cut_off": null,
	          "delivery_date": null,
	          "transit_time": null,
	          "detailed_charges": [],
	          "error_message": null,
	          "info_message": "No rate quotes returned from carrier."
	        },
	        "created_at": "2015-11-27T08:42:06+00:00",
	        "updated_at": "2015-11-27T08:42:06+00:00"
	      },
	      {
	        "id": "cc96267e-95aa-4594-a9db-92c51e499f70",
	        "status": "cancelled",
	        "tracking_numbers": [
	          "PREF10000000000147"
	        ],
	        "files": {
	          "label": {
	            "paper_size": "6x4",
	            "url": "https://sandbox-download.postmen.com/label/2015-11-27/00000000-0000-0000-0000-000000000000-1441785264309885.pdf",
	            "file_type": "pdf"
	          },
	          "invoice": null,
	          "customs_declaration": null,
	          "manifest": null
	        },
	        "rate": {
	          "charge_weight": {
	            "value": 9.54,
	            "unit": "kg"
	          },
	          "total_charge": null,
	          "shipper_account": {
	            "id": "00000000-0000-0000-0000-000000000000",
	            "slug": "spsr",
	            "description": "spsr (Runscope)"
	          },
	          "service_type": "spsr_gepintl",
	          "service_name": "GEPINTL",
	          "pickup_deadline": null,
	          "booking_cut_off": null,
	          "delivery_date": null,
	          "transit_time": null,
	          "detailed_charges": [],
	          "error_message": null,
	          "info_message": "No rate quotes returned from carrier."
	        },
	        "created_at": "2015-11-27T08:41:02+00:00",
	        "updated_at": "2015-11-27T08:41:05+00:00"
	      },
	      {
	        "id": "478d1ae0-9a26-4f97-8da2-9b946f711f6c",
	        "status": "created",
	        "tracking_numbers": [
	          "PREF10000000000146"
	        ],
	        "files": {
	          "label": {
	            "paper_size": "6x4",
	            "url": "https://sandbox-download.postmen.com/label/2015-11-27/00000000-0000-0000-0000-000000000000-1441785264309885.pdf",
	            "file_type": "pdf"
	          },
	          "invoice": null,
	          "customs_declaration": null,
	          "manifest": null
	        },
	        "rate": {
	          "charge_weight": {
	            "value": 9.54,
	            "unit": "kg"
	          },
	          "total_charge": null,
	          "shipper_account": {
	            "id": "00000000-0000-0000-0000-000000000000",
	            "slug": "spsr",
	            "description": "spsr (Runscope)"
	          },
	          "service_type": "spsr_gepintl",
	          "service_name": "GEPINTL",
	          "pickup_deadline": null,
	          "booking_cut_off": null,
	          "delivery_date": null,
	          "transit_time": null,
	          "detailed_charges": [],
	          "error_message": null,
	          "info_message": "No rate quotes returned from carrier."
	        },
	        "created_at": "2015-11-27T08:40:40+00:00",
	        "updated_at": "2015-11-27T08:40:47+00:00"
	      },
	      {
	        "id": "c11a5651-7683-4eb7-be6e-daef215f24fd",
	        "status": "created",
	        "tracking_numbers": [
	          "GE874105291HK"
	        ],
	        "files": {
	          "label": {
	            "paper_size": "a4",
	            "url": "https://sandbox-download.postmen.com/label/2015-11-27/00000000-0000-0000-0000-000000000000-1441785264309885.pdf",
	            "file_type": "pdf"
	          },
	          "invoice": null,
	          "customs_declaration": null,
	          "manifest": null
	        },
	        "rate": {
	          "charge_weight": null,
	          "total_charge": {
	            "amount": 227.75,
	            "currency": "USD"
	          },
	          "shipper_account": {
	            "id": "00000000-0000-0000-0000-000000000000",
	            "slug": "tnt",
	            "description": "tnt (Runscope)"
	          },
	          "service_type": "tnt_economy_express",
	          "service_name": "TNT Economy Express",
	          "pickup_deadline": null,
	          "booking_cut_off": null,
	          "delivery_date": null,
	          "transit_time": null,
	          "detailed_charges": [],
	          "error_message": null,
	          "info_message": "P13:RATEID: POSTMEN-REF - STANDARD RATES."
	        },
	        "created_at": "2015-11-27T08:30:51+00:00",
	        "updated_at": "2015-11-27T08:30:57+00:00"
	      },
	      {
	        "id": "1306e565-fc50-4a65-946f-663a9ffcf80a",
	        "status": "manifested",
	        "tracking_numbers": [
	          "RP200381450SG"
	        ],
	        "files": {
	          "label": {
	            "paper_size": "default",
	            "url": "https://sandbox-download.postmen.com/label/2015-11-27/00000000-0000-0000-0000-000000000000-1441785264309885.pdf",
	            "file_type": "pdf"
	          },
	          "invoice": null,
	          "customs_declaration": null,
	          "manifest": null
	        },
	        "rate": {
	          "charge_weight": {
	            "value": 1.2,
	            "unit": "kg"
	          },
	          "total_charge": null,
	          "shipper_account": {
	            "id": "00000000-0000-0000-0000-000000000000",
	            "slug": "quantium",
	            "description": "quantium (Runscope)"
	          },
	          "service_type": "quantium_registered",
	          "service_name": "ezyparcels Registered",
	          "pickup_deadline": null,
	          "booking_cut_off": null,
	          "delivery_date": null,
	          "transit_time": null,
	          "detailed_charges": [],
	          "error_message": null,
	          "info_message": "No rate quotes returned from carrier."
	        },
	        "created_at": "2015-11-27T08:29:59+00:00",
	        "updated_at": "2015-11-27T08:30:22+00:00"
	      },
	      {
	        "id": "bfda1bc6-4e9b-4703-a3ce-dd5f8189a76b",
	        "status": "created",
	        "tracking_numbers": [
	          "USERREF3629F4C04BEDEEA229"
	        ],
	        "files": {
	          "label": {
	            "paper_size": "a4",
	            "url": "https://sandbox-download.postmen.com/label/2015-11-27/00000000-0000-0000-0000-000000000000-1441785264309885.pdf",
	            "file_type": "pdf"
	          },
	          "invoice": null,
	          "customs_declaration": null,
	          "manifest": null
	        },
	        "rate": {
	          "charge_weight": {
	            "value": 9.54,
	            "unit": "kg"
	          },
	          "total_charge": null,
	          "shipper_account": {
	            "id": "00000000-0000-0000-0000-000000000000",
	            "slug": "dhl-global-mail-asia",
	            "description": "dhl-global-mail-asia (Runscope)"
	          },
	          "service_type": "dhl-global-mail-asia_plt",
	          "service_name": "Parcel Direct",
	          "pickup_deadline": null,
	          "booking_cut_off": null,
	          "delivery_date": null,
	          "transit_time": null,
	          "detailed_charges": [],
	          "error_message": null,
	          "info_message": "No rate quotes returned from carrier."
	        },
	        "created_at": "2015-11-27T08:29:38+00:00",
	        "updated_at": "2015-11-27T08:29:38+00:00"
	      },
	      {
	        "id": "821183a2-92df-49ab-bb7c-4770b7aceb05",
	        "status": "created",
	        "tracking_numbers": [],
	        "files": {
	          "label": {
	            "paper_size": "4x4",
	            "url": "https://sandbox-download.postmen.com/label/2015-11-27/00000000-0000-0000-0000-000000000000-1441785264309885.pdf",
	            "file_type": "pdf"
	          },
	          "invoice": {
	            "paper_size": "a4",
	            "url": "https://sandbox-download.postmen.com/invoice/2015-11-27/00000000-0000-0000-0000-000000000000-1441785264309885.pdf",
	            "file_type": "pdf"
	          },
	          "customs_declaration": null,
	          "manifest": null
	        },
	        "rate": {
	          "charge_weight": null,
	          "total_charge": null,
	          "shipper_account": {
	            "id": "00000000-0000-0000-0000-000000000000",
	            "slug": "dpd-uk",
	            "description": "dpd-uk (Runscope)"
	          },
	          "service_type": "dpd-uk_parcel_2d",
	          "service_name": "Parcel - Two Day",
	          "pickup_deadline": null,
	          "booking_cut_off": null,
	          "delivery_date": null,
	          "transit_time": null,
	          "detailed_charges": [],
	          "error_message": null,
	          "info_message": "No rate quotes returned from carrier."
	        },
	        "created_at": "2015-11-27T08:29:35+00:00",
	        "updated_at": "2015-11-27T08:29:41+00:00"
	      },
	      {
	        "id": "2eec8347-8518-45ce-88af-03f4054341b9",
	        "status": "created",
	        "tracking_numbers": [
	          "BLVS1300010000121750"
	        ],
	        "files": {
	          "label": {
	            "paper_size": "4x4",
	            "url": "https://sandbox-download.postmen.com/label/2015-11-27/00000000-0000-0000-0000-000000000000-1441785264309885.pdf",
	            "file_type": "pdf"
	          },
	          "invoice": {
	            "paper_size": "a4",
	            "url": "https://sandbox-download.postmen.com/invoice/2015-11-27/00000000-0000-0000-0000-000000000000-1441785264309885.pdf",
	            "file_type": "pdf"
	          },
	          "customs_declaration": null,
	          "manifest": null
	        },
	        "rate": {
	          "charge_weight": {
	            "value": 2,
	            "unit": "kg"
	          },
	          "total_charge": null,
	          "shipper_account": {
	            "id": "00000000-0000-0000-0000-000000000000",
	            "slug": "bpost-international",
	            "description": "bpost-international (Runscope)"
	          },
	          "service_type": "bpost-international_minipakeu",
	          "service_name": "MinipakEU",
	          "pickup_deadline": null,
	          "booking_cut_off": null,
	          "delivery_date": null,
	          "transit_time": null,
	          "detailed_charges": [],
	          "error_message": null,
	          "info_message": "No rate quotes returned from carrier."
	        },
	        "created_at": "2015-11-27T08:29:29+00:00",
	        "updated_at": "2015-11-27T08:29:36+00:00"
	      },
	      {
	        "id": "b3d75a21-9d27-4b1b-9592-485667f59e3f",
	        "status": "cancelled",
	        "tracking_numbers": [],
	        "files": {
	          "label": {
	            "paper_size": "default",
	            "url": "https://sandbox-download.postmen.com/label/2015-11-27/00000000-0000-0000-0000-000000000000-1441785264309885.pdf",
	            "file_type": "pdf"
	          },
	          "invoice": null,
	          "customs_declaration": null,
	          "manifest": null
	        },
	        "rate": {
	          "charge_weight": {
	            "value": 9,
	            "unit": "lb"
	          },
	          "total_charge": {
	            "amount": 34.82,
	            "currency": "CAD"
	          },
	          "shipper_account": {
	            "id": "00000000-0000-0000-0000-000000000000",
	            "slug": "canpar",
	            "description": "canpar (Runscope)"
	          },
	          "service_type": "canpar_ground",
	          "service_name": "GROUND",
	          "pickup_deadline": null,
	          "booking_cut_off": null,
	          "delivery_date": "2015-12-02T05:00:00+00:00",
	          "transit_time": 3,
	          "detailed_charges": [
	            {
	              "type": "Freight Charge",
	              "charge": {
	                "amount": 30.41,
	                "currency": "CAD"
	              }
	            },
	            {
	              "type": "Residential Address Charge",
	              "charge": {
	                "amount": 2.75,
	                "currency": "CAD"
	              }
	            },
	            {
	              "type": "GST",
	              "charge": {
	                "amount": 1.66,
	                "currency": "CAD"
	              }
	            }
	          ],
	          "error_message": null,
	          "info_message": null
	        },
	        "created_at": "2015-11-27T08:25:07+00:00",
	        "updated_at": "2015-11-27T08:25:13+00:00"
	      },
	      {
	        "id": "c841654b-5a2a-4888-a369-56bac91d09d5",
	        "status": "manifested",
	        "tracking_numbers": [
	          "RP200381432SG"
	        ],
	        "files": {
	          "label": {
	            "paper_size": "default",
	            "url": "https://sandbox-download.postmen.com/label/2015-11-27/00000000-0000-0000-0000-000000000000-1441785264309885.pdf",
	            "file_type": "pdf"
	          },
	          "invoice": null,
	          "customs_declaration": null,
	          "manifest": null
	        },
	        "rate": {
	          "charge_weight": {
	            "value": 1.2,
	            "unit": "kg"
	          },
	          "total_charge": null,
	          "shipper_account": {
	            "id": "00000000-0000-0000-0000-000000000000",
	            "slug": "quantium",
	            "description": "quantium (Runscope)"
	          },
	          "service_type": "quantium_registered",
	          "service_name": "ezyparcels Registered",
	          "pickup_deadline": null,
	          "booking_cut_off": null,
	          "delivery_date": null,
	          "transit_time": null,
	          "detailed_charges": [],
	          "error_message": null,
	          "info_message": "No rate quotes returned from carrier."
	        },
	        "created_at": "2015-11-27T08:25:04+00:00",
	        "updated_at": "2015-11-27T08:30:22+00:00"
	      },
	      {
	        "id": "22e406f5-e4d2-4a1d-9b65-a98557fca6eb",
	        "status": "created",
	        "tracking_numbers": [
	          "BN58705188"
	        ],
	        "files": {
	          "label": null,
	          "invoice": {
	            "paper_size": "a4",
	            "url": "https://sandbox-download.postmen.com/invoice/2015-11-27/00000000-0000-0000-0000-000000000000-1441785264309885.pdf",
	            "file_type": "pdf"
	          },
	          "customs_declaration": null,
	          "manifest": null
	        },
	        "rate": {
	          "charge_weight": null,
	          "total_charge": null,
	          "shipper_account": {
	            "id": "00000000-0000-0000-0000-000000000000",
	            "slug": "parcelled-in",
	            "description": "parcelled-in (Runscope)"
	          },
	          "service_type": "parcelled-in_rush",
	          "service_name": "Rush",
	          "pickup_deadline": "2015-11-27T02:30:00",
	          "booking_cut_off": null,
	          "delivery_date": null,
	          "transit_time": null,
	          "detailed_charges": [],
	          "error_message": null,
	          "info_message": "No rate quotes returned from carrier."
	        },
	        "created_at": "2015-11-27T08:24:42+00:00",
	        "updated_at": "2015-11-27T08:24:42+00:00"
	      },
	      {
	        "id": "9b4b8c9c-41d2-467b-b4b2-97834046b7c7",
	        "status": "manifested",
	        "tracking_numbers": [
	          "0470110200882101123951"
	        ],
	        "files": {
	          "label": {
	            "paper_size": "4x6",
	            "url": "https://sandbox-download.postmen.com/label/2015-11-27/00000000-0000-0000-0000-000000000000-1441785264309885.pdf",
	            "file_type": "pdf"
	          },
	          "invoice": {
	            "paper_size": "a4",
	            "url": "https://sandbox-download.postmen.com/invoice/2015-11-27/00000000-0000-0000-0000-000000000000-1441785264309885.pdf",
	            "file_type": "pdf"
	          },
	          "customs_declaration": null,
	          "manifest": null
	        },
	        "rate": {
	          "charge_weight": null,
	          "total_charge": {
	            "amount": 16.3,
	            "currency": "USD"
	          },
	          "shipper_account": {
	            "id": "00000000-0000-0000-0000-000000000000",
	            "slug": "endicia",
	            "description": "endicia (Runscope)"
	          },
	          "service_type": "endicia_priority_mail_express",
	          "service_name": "Endicia Priority Mail Express",
	          "pickup_deadline": null,
	          "booking_cut_off": null,
	          "delivery_date": null,
	          "transit_time": 1,
	          "detailed_charges": [],
	          "error_message": null,
	          "info_message": null
	        },
	        "created_at": "2015-11-27T08:24:39+00:00",
	        "updated_at": "2015-11-27T08:24:52+00:00"
	      },
	      {
	        "id": "e0e54d73-b7d3-4972-893f-e280775d7e05",
	        "status": "created",
	        "tracking_numbers": [
	          "49950452315"
	        ],
	        "files": {
	          "label": {
	            "paper_size": "4x6",
	            "url": "https://sandbox-download.postmen.com/label/2015-11-27/00000000-0000-0000-0000-000000000000-1441785264309885.pdf",
	            "file_type": "pdf"
	          },
	          "invoice": {
	            "paper_size": "a4",
	            "url": "https://sandbox-download.postmen.com/invoice/2015-11-27/00000000-0000-0000-0000-000000000000-1441785264309885.pdf",
	            "file_type": "pdf"
	          },
	          "customs_declaration": null,
	          "manifest": null
	        },
	        "rate": {
	          "charge_weight": null,
	          "total_charge": null,
	          "shipper_account": {
	            "id": "00000000-0000-0000-0000-000000000000",
	            "slug": "purolator",
	            "description": "purolator (Runscope)"
	          },
	          "service_type": "purolator_ground_us",
	          "service_name": "Ground US",
	          "pickup_deadline": null,
	          "booking_cut_off": null,
	          "delivery_date": null,
	          "transit_time": null,
	          "detailed_charges": [],
	          "error_message": null,
	          "info_message": "No rate quotes returned from carrier."
	        },
	        "created_at": "2015-11-27T08:24:20+00:00",
	        "updated_at": "2015-11-27T08:24:23+00:00"
	      }
	    ]
	  }
	}

Shipper Accounts

Shipper Accounts

POST Create a shipper account

Try it 
/shipper-accounts

Create a shipper account

NameTypeDescription
slug string Courier Slug Accepts: colissimo.
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

	{
	  "slug": "colissimo",
	  "description": "colissimo-description",
	  "credentials": {
	    "contract_number": "***********",
	    "password": "***********"
	  },
	  "timezone": "Asia/Hong_Kong",
	  "address": {
	    "contact_name": "test contact name",
	    "phone": "***********",
	    "fax": "***********",
	    "email": "***********",
	    "company_name": "test company name",
	    "street1": "fra street1",
	    "street2": "fra street2",
	    "city": "Paris",
	    "postal_code": "75007",
	    "country": "FRA",
	    "type": "business",
	    "tax_id": "***********"
	  }
	}
	

	curl --request POST \
	    --url https://sandbox-api.postmen.com/v3/shipper-accounts \
	    --header 'content-type: application/json' \
	    --header 'postmen-api-key: 8fc7966b-679b-4a57-911d-c5a663229c9e' \
	    --data '{"slug":"colissimo","description":"colissimo-description","credentials":{"contract_number":"***********","password":"***********"},"timezone":"Asia/Hong_Kong","address":{"contact_name":"test contact name","phone":"***********","fax":"***********","email":"***********","company_name":"test company name","street1":"fra street1","street2":"fra street2","city":"Paris","postal_code":"75007","country":"FRA","type":"business","tax_id":"***********"}}'
	

	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/shipper-accounts");
	        string json = "{\"slug\":\"colissimo\",\"description\":\"colissimo-description\",\"credentials\":{\"contract_number\":\"***********\",\"password\":\"***********\"},\"timezone\":\"Asia/Hong_Kong\",\"address\":{\"contact_name\":\"test contact name\",\"phone\":\"***********\",\"fax\":\"***********\",\"email\":\"***********\",\"company_name\":\"test company name\",\"street1\":\"fra street1\",\"street2\":\"fra street2\",\"city\":\"Paris\",\"postal_code\":\"75007\",\"country\":\"FRA\",\"type\":\"business\",\"tax_id\":\"***********\"}}";
	
	        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, "{\"slug\":\"colissimo\",\"description\":\"colissimo-description\",\"credentials\":{\"contract_number\":\"***********\",\"password\":\"***********\"},\"timezone\":\"Asia/Hong_Kong\",\"address\":{\"contact_name\":\"test contact name\",\"phone\":\"***********\",\"fax\":\"***********\",\"email\":\"***********\",\"company_name\":\"test company name\",\"street1\":\"fra street1\",\"street2\":\"fra street2\",\"city\":\"Paris\",\"postal_code\":\"75007\",\"country\":\"FRA\",\"type\":\"business\",\"tax_id\":\"***********\"}}");
	
	    	Request request = new Request.Builder()
	    		.url("https://sandbox-api.postmen.com/v3/shipper-accounts")
	            .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/shipper-accounts',
	    headers: {
			'content-type': 'application/json',
	        'postmen-api-key': '8fc7966b-679b-4a57-911d-c5a663229c9e'
		},
	    body: '{"slug":"colissimo","description":"colissimo-description","credentials":{"contract_number":"***********","password":"***********"},"timezone":"Asia/Hong_Kong","address":{"contact_name":"test contact name","phone":"***********","fax":"***********","email":"***********","company_name":"test company name","street1":"fra street1","street2":"fra street2","city":"Paris","postal_code":"75007","country":"FRA","type":"business","tax_id":"***********"}}'
	};
	
	request(options, function (error, response, body) {
	    if (error) throw new Error(error);
	    console.log(body);
	});

	<?php
	
	    $url = 'https://sandbox-api.postmen.com/v3/shipper-accounts';
	    $method = 'POST';
	    $headers = array(
	        "content-type: application/json",
	        "postmen-api-key: 8fc7966b-679b-4a57-911d-c5a663229c9e"
	    );
	    $body = '{"slug":"colissimo","description":"colissimo-description","credentials":{"contract_number":"***********","password":"***********"},"timezone":"Asia/Hong_Kong","address":{"contact_name":"test contact name","phone":"***********","fax":"***********","email":"***********","company_name":"test company name","street1":"fra street1","street2":"fra street2","city":"Paris","postal_code":"75007","country":"FRA","type":"business","tax_id":"***********"}}';
	
	    $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/shipper-accounts'
	
	payload = '''
	{
	  "slug": "colissimo",
	  "description": "colissimo-description",
	  "credentials": {
	    "contract_number": "***********",
	    "password": "***********"
	  },
	  "timezone": "Asia/Hong_Kong",
	  "address": {
	    "contact_name": "test contact name",
	    "phone": "***********",
	    "fax": "***********",
	    "email": "***********",
	    "company_name": "test company name",
	    "street1": "fra street1",
	    "street2": "fra street2",
	    "city": "Paris",
	    "postal_code": "75007",
	    "country": "FRA",
	    "type": "business",
	    "tax_id": "***********"
	  }
	}
	'''
	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/shipper-accounts')
	
	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 = '{"slug":"colissimo","description":"colissimo-description","credentials":{"contract_number":"***********","password":"***********"},"timezone":"Asia/Hong_Kong","address":{"contact_name":"test contact name","phone":"***********","fax":"***********","email":"***********","company_name":"test company name","street1":"fra street1","street2":"fra street2","city":"Paris","postal_code":"75007","country":"FRA","type":"business","tax_id":"***********"}}'
	
	response = http.request(request)
	puts response.read_body
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

{
	  "meta": {
	    "code": 200,
	    "message": "OK",
	    "details": []
	  },
	  "data": {
	    "id": "***********",
	    "description": "colissimo-description",
	    "slug": "colissimo",
	    "status": "enabled",
	    "timezone": "Asia/Hong_Kong",
	    "type": "user",
	    "created_at": "2022-01-12T04:59:42+00:00",
	    "updated_at": "2022-01-12T04:59:42+00:00",
	    "account_balance": null,
	    "address": {
	      "contact_name": "test contact name",
	      "phone": "***********",
	      "fax": "***********",
	      "email": "***********",
	      "company_name": "test company name",
	      "street1": "fra street1",
	      "street2": "fra street2",
	      "city": "Paris",
	      "postal_code": "75007",
	      "country": "FRA",
	      "type": "business",
	      "tax_id": "***********"
	    },
	    "settings": null,
	    "extra_info": null
	  }
	}

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

PATCH Update a shipper account credentials

Try it 
/shipper-accounts/:id/credentials

Update a shipper account credentials

NameTypeDescription
contract_number string
password 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,third_party,recipient.
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

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: FRA.
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
eori_number string eori number

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 The country origin of the item 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,a4,4x6. (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: FRA.
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
username * string username for ftp upload
password * string password for ftp upload

FTP

FTP credentials object

NameTypeDescription
url * string protocol://domain + port + path
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

Location

location for latitude and longitude

NameTypeDescription
lat number latitude number
lng number longitude number

Money

money object

NameTypeDescription
amount * number amount
currency * string Currency in ISO 4217 code Accepts: EUR.

Passport

Passport 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: FRA.

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: colissimo_return_france.
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 - General

General Service Option object

NameTypeDescription
type * string Service Option General Type Accepts: insurance.
enabled * boolean Accepts: true,false.

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: FRA.
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
eori_number string eori number
location location location for latitude and longitude

Ship To Address

Address object

NameTypeDescription
country * string Country in ISO 3166-1 alpha 3 code Accepts: FRA.
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
eori_number string eori number
location location location for latitude and longitude

Shipper Account Credentials

Shipper Account Credentials

NameTypeDescription
contract_number * string
password * string

Shipper Account Information

Shipper Account (brief information for rate and manifest responses)

NameTypeDescription
id * string Shipper Account ID
slug * string Courier Slug Accepts: colissimo.
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: FRA.
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.

Bulk Download Status

Bulk Download Status

Accepts:
creating,created,failed.

Box Type

Type of box for packaging

Accepts:
custom.

Country Code

Country in ISO 3166-1 alpha 3 code

Accepts:
FRA.

Label File Type

Label file type

Accepts:
pdf.

Currency Code

Currency in ISO 4217 code

Accepts:
EUR.

Label Paper Size

Label Paper Size

Accepts:
default,a4,4x6.

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 status

Status of Task

Accepts:
pending,success,failed,complete.

Postmen string

A string with a maximum length of 255 characters.

Min length:
1
Max length:
255

Postmen order number

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

Min length:
1
Max length:
50

Service Option General Type

Service Option General Type

Accepts:
insurance.

Label References

Reference numbers for a label

Service Type

Service Types

Accepts:
colissimo_return_france.

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

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.

Courier Slug

Courier Slug

Accepts:
colissimo.