Create Manifests

What are Manifests?

A manifest is a list of shipments. Manifests typically include data for each shipment like recipient name, service, tracking numbers, package details, shipping date, and other information.

Some carriers require a paper manifest for their driver at pickup, while others receive electronic manifests when you create a label. Electronic manifests make paper manifests unnecessary. However, some providers, like USPS require manifests when shipping large numbers of packages.

A manifest exists so the carrier can scan the manifest and check in all the packages being shipped. Think about how long it would take for a delivery driver to arrive, pick up 100 packages, and individually scan each of them.

While ShipEngine uses the term "manifest" to refer to these lists of packages, some carriers use other terminology, such as:

Shipment manifest
SCAN form
Order Summary
End of Day form

When are Manifests Needed?

Some carriers require manifests (paper and/or electronic) to properly process shipments. Manifests help postal workers and warehouse staff to work efficiently. Creating a manifest allows the warehouse to 'close out' what they're going to send with the postal worker and move to a new grouping.

Not all carriers require manifests. Some carriers make the manifest process optional, and may offer manifests in a PDF version.

Manifest Requirements by Carrier

Not all carriers require a manifest, and some may make them optional. Many carriers require you to print a PDF form and present it to the driver upon pickup. Some carriers support electronic manifesting, in which case ShipEngine will automatically submit the manifest for you.

Carrier Name	Manifest Required?	Manifest Method
Access Worldwide	REQUIRED
APC	REQUIRED	PDF download
Asendia	REQUIRED
Australia Post	REQUIRED[^1]	PDF download
Canada Post	REQUIRED	PDF download
DHL eCommerce	REQUIRED	PDF[^2]
DHL Express AU	NO	N/A
DHL Express Canada	NO	N/A
DHL Express UK	REQUIRED	Electronically submitted
DHL Express (US)	NO	N/A
DPD	NO	N/A
FedEx (US, CA)	Optional [^3]	PDF download
FedEx UK	REQUIRED	PDF download
FedEx International MailService	NO
FirstMile	REQUIRED	Electronically submitted
Globegistics	REQUIRED	PDF download
Hermes	NO	N/A
IMEX	REQUIRED [^4]	PDF download
LSO (Lone Star Overnight)	NO	N/A
Newgistics	REQUIRED	Electronically submitted
OnTrac	NO	N/A
Parcelforce	NO	N/A
Purolator Canada	REQUIRED [^4]	PDF download
Royal Mail	REQUIRED	PDF download
RR Donnelley	REQUIRED	PDF download
Sendle	NO	N/A
UPS (CA, UK, US)	Optional [^5]
UPS Mail Innovations	NO
USPS	Optional	PDF download

[^1]: Australia Post calls this form Order Summary Report.

[^2]: PDF available via Endicia and ShipEngine, but not DHL eCommerce.

[^3]: _FedEx provides a PDF only for FedEx Ground Shipments that meet certain criteria. For certain kinds of FedEx Ground and FedEx Home Delivery shipments, a FedEx Ground Manifest will be available to print from ShipEngine. Print this form within the End of Day section in the Shipments tab. To be included in the FedEx Ground Manifest, a shipment must meet one or more of the following criteria:

Collect on Delivery Amount (COD Amount)
Declared Value greater than $100 U.S. dollars
Oversize (Length + Girth greater than 84")
Additional Handling applied to shipment
Acknowledgment of Delivery (A.O.D)
Residential delivery address_

[^4]: Submitted electronically through ShipEngine

[^5]: Optional via EDI apply to UPS via their Paperless Invoice Enrollment Page

Creating Manifests in ShipEngine

ShipEngine has two different ways to create manifests:

Explicit Manifests
Specify exactly which labels to include in the manifest.
Implicit Manifests
Allow ShipEngine to automatically create manifests for all packages shipped from a single warehouse on a given day.

Explicit Manifests

One way to create manifests in ShipEngine is to explicitly specify which labels to include in the manifest. You can include up to 500 labels per manifest.

To create an explicit manifest, you only need to set a single field:

Field Name	Type	Required?	Description
`label_ids`	array of strings	yes	Use this to group labels that you want shipped with that manifest.

Warning When using the label_ids property, all the listed labels need to share the same carrier_id, warehouse_id, and ship_date.

Example Request

POST /v1/manifests HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json

{
  "label_ids": ["se-29602037", "se-29544722", "se-29475869"]
}

curl -iX POST https://api.shipengine.com/v1/manifests \
-H 'API-Key: __YOUR_API_KEY_HERE__' \
-H 'Content-Type: application/json' \
-d '{
  "label_ids": ["se-29602037", "se-29544722", "se-29475869"]
}'

$headers = New-Object "System.Collections.Generic.Dictionary[[String],[String]]"
$headers.Add("Host", "api.shipengine.com")
$headers.Add("API-Key", "__YOUR_API_KEY_HERE__")
$headers.Add("Content-Type", "application/json")

$body = "{`n  `"label_ids`": [`"se-29602037`", `"se-29544722`", `"se-29475869`"]`n}"

$response = Invoke-RestMethod 'https://api.shipengine.com/v1/manifests' -Method 'POST' -Headers $headers -Body $body
$response | ConvertTo-Json

var myHeaders = new Headers();
myHeaders.append("Host", "api.shipengine.com");
myHeaders.append("API-Key", "__YOUR_API_KEY_HERE__");
myHeaders.append("Content-Type", "application/json");

var raw = JSON.stringify({"label_ids":["se-29602037","se-29544722","se-29475869"]});

var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: raw,
  redirect: 'follow'
};

fetch("https://api.shipengine.com/v1/manifests", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://api.shipengine.com/v1/manifests',
  'headers': {
    'Host': 'api.shipengine.com',
    'API-Key': '__YOUR_API_KEY_HERE__',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({"label_ids":["se-29602037","se-29544722","se-29475869"]})

};
request(options, function (error, response) { 
  if (error) throw new Error(error);
  console.log(response.body);
});

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api.shipengine.com/v1/manifests",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS =>"{\n  \"label_ids\": [\"se-29602037\", \"se-29544722\", \"se-29475869\"]\n}",
  CURLOPT_HTTPHEADER => array(
    "Host: api.shipengine.com",
    "API-Key: __YOUR_API_KEY_HERE__",
    "Content-Type: application/json"
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

import requests

url = "https://api.shipengine.com/v1/manifests"

payload = "{\n  \"label_ids\": [\"se-29602037\", \"se-29544722\", \"se-29475869\"]\n}"
headers = {
  'Host': 'api.shipengine.com',
  'API-Key': '__YOUR_API_KEY_HERE__',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data = payload)

print(response.text.encode('utf8'))

require "uri"
require "net/http"

url = URI("https://api.shipengine.com/v1/manifests")

https = Net::HTTP.new(url.host, url.port);
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Host"] = "api.shipengine.com"
request["API-Key"] = "__YOUR_API_KEY_HERE__"
request["Content-Type"] = "application/json"
request.body = "{\n  \"label_ids\": [\"se-29602037\", \"se-29544722\", \"se-29475869\"]\n}"

response = https.request(request)
puts response.read_body

var client = new RestClient("https://api.shipengine.com/v1/manifests");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("Host", "api.shipengine.com");
request.AddHeader("API-Key", "__YOUR_API_KEY_HERE__");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n  \"label_ids\": [\"se-29602037\", \"se-29544722\", \"se-29475869\"]\n}",  ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\n  \"label_ids\": [\"se-29602037\", \"se-29544722\", \"se-29475869\"]\n}");
Request request = new Request.Builder()
  .url("https://api.shipengine.com/v1/manifests")
  .method("POST", body)
  .addHeader("Host", "api.shipengine.com")
  .addHeader("API-Key", "__YOUR_API_KEY_HERE__")
  .addHeader("Content-Type", "application/json")
  .build();
Response response = client.newCall(request).execute();

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://api.shipengine.com/v1/manifests"
  method := "POST"

  payload := strings.NewReader("{\n  \"label_ids\": [\"se-29602037\", \"se-29544722\", \"se-29475869\"]\n}")

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
  }
  req.Header.Add("Host", "api.shipengine.com")
  req.Header.Add("API-Key", "__YOUR_API_KEY_HERE__")
  req.Header.Add("Content-Type", "application/json")

  res, err := client.Do(req)
  defer res.Body.Close()
  body, err := ioutil.ReadAll(res.Body)

  fmt.Println(string(body))
}

#import <Foundation/Foundation.h>

dispatch_semaphore_t sema = dispatch_semaphore_create(0);

NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:@"https://api.shipengine.com/v1/manifests"]
  cachePolicy:NSURLRequestUseProtocolCachePolicy
  timeoutInterval:10.0];
NSDictionary *headers = @{
  @"Host": @"api.shipengine.com",
  @"API-Key": @"__YOUR_API_KEY_HERE__",
  @"Content-Type": @"application/json"
};

[request setAllHTTPHeaderFields:headers];
NSData *postData = [[NSData alloc] initWithData:[@"{\n  \"label_ids\": [\"se-29602037\", \"se-29544722\", \"se-29475869\"]\n}" dataUsingEncoding:NSUTF8StringEncoding]];
[request setHTTPBody:postData];

[request setHTTPMethod:@"POST"];

NSURLSession *session = [NSURLSession sharedSession];
NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request
completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
  if (error) {
    NSLog(@"%@", error);
  } else {
    NSHTTPURLResponse *httpResponse = (NSHTTPURLResponse *) response;
    NSError *parseError = nil;
    NSDictionary *responseDictionary = [NSJSONSerialization JSONObjectWithData:data options:0 error:&parseError];
    NSLog(@"%@",responseDictionary);
    dispatch_semaphore_signal(sema);
  }
}];
[dataTask resume];
dispatch_semaphore_wait(sema, DISPATCH_TIME_FOREVER);

import Foundation

var semaphore = DispatchSemaphore (value: 0)

let parameters = "{\n  \"label_ids\": [\"se-29602037\", \"se-29544722\", \"se-29475869\"]\n}"
let postData = parameters.data(using: .utf8)

var request = URLRequest(url: URL(string: "https://api.shipengine.com/v1/manifests")!,timeoutInterval: Double.infinity)
request.addValue("api.shipengine.com", forHTTPHeaderField: "Host")
request.addValue("__YOUR_API_KEY_HERE__", forHTTPHeaderField: "API-Key")
request.addValue("application/json", forHTTPHeaderField: "Content-Type")

request.httpMethod = "POST"
request.httpBody = postData

let task = URLSession.shared.dataTask(with: request) { data, response, error in 
  guard let data = data else {
    print(String(describing: error))
    return
  }
  print(String(data: data, encoding: .utf8)!)
  semaphore.signal()
}

task.resume()
semaphore.wait()

Example Response

{
  "manifests": [
    {
      "manifest_id": "se-17618625",
      "form_id": "se-28529731",
      "created_at": "2019-07-12T13:37:39.050Z",
      "ship_date": "2019-07-25T05:00:00.000Z",
      "shipments": 100,
      "warehouse_id": "se-28529731",
      "submission_id": "9475711899564878915476",
      "carrier_id": "se-123890",
      "manifest_download": {
        "href": "http://api.shipengine.com/v1/labels/se-28529731"
      }
    }
  ]
}

{
  "manifests": [
    {
      "manifest_id": "se-17618625",
      "form_id": "se-28529731",
      "created_at": "2019-07-12T13:37:39.050Z",
      "ship_date": "2019-07-25T05:00:00.000Z",
      "shipments": 100,
      "warehouse_id": "se-28529731",
      "submission_id": "9475711899564878915476",
      "carrier_id": "se-123890",
      "manifest_download": {
        "href": "http://api.shipengine.com/v1/labels/se-28529731"
      }
    }
  ]
}

Implicit Manifests

Specify a carrier + warehouse + ship date to manifest all of the corresponding labels and automatically exclude any other labels from the manifest.

The parameters below explain each method.

Property	Description
`carrier_id`	string, required The Carrier ID you wish to create a manifest for.
`excluded_label_ids`	string array Use this to exclude any labels created with this `ship_date` that will not be shipped today.
`warehouse_id`	string, required The Warehouse ID this manifest is being created for.
`ship_date`	date string, (ISO 8601 Standard), required `2019-07-25T15:24:46.657Z`

Warning

Use warehouse_id instead of ship_from when creating a manifest.

Each ShipEngine manifest is created for a specific warehouse, so you'll need to provide the warehouse_id rather than the ship_from address. You can create a warehouse for each location that you want to create manifests for.

Example

POST /v1/manifests

POST /v1/labels HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json

{
  "carrier_id": "se-123890",
  "excluded_label_ids": [],
  "warehouse_id": "se-11921",
  "ship_date": "2019-07-25T05:00:00.000Z"
}

curl -iX POST https://api.shipengine.com/v1/labels \
-H 'API-Key: __YOUR_API_KEY_HERE__' \
-H 'Content-Type: application/json' \
-d '{
  "carrier_id": "se-123890",
  "excluded_label_ids": [],
  "warehouse_id": "se-11921",
  "ship_date": "2019-07-25T05:00:00.000Z"
}'

$headers = New-Object "System.Collections.Generic.Dictionary[[String],[String]]"
$headers.Add("Host", "api.shipengine.com")
$headers.Add("API-Key", "__YOUR_API_KEY_HERE__")
$headers.Add("Content-Type", "application/json")

$body = "{`n  `"carrier_id`": `"se-123890`",`n  `"excluded_label_ids`": [],`n  `"warehouse_id`": `"se-11921`",`n  `"ship_date`": `"2019-07-25T05:00:00.000Z`"`n}"

$response = Invoke-RestMethod 'https://api.shipengine.com/v1/labels' -Method 'POST' -Headers $headers -Body $body
$response | ConvertTo-Json

var myHeaders = new Headers();
myHeaders.append("Host", "api.shipengine.com");
myHeaders.append("API-Key", "__YOUR_API_KEY_HERE__");
myHeaders.append("Content-Type", "application/json");

var raw = JSON.stringify({"carrier_id":"se-123890","excluded_label_ids":[],"warehouse_id":"se-11921","ship_date":"2019-07-25T05:00:00.000Z"});

var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: raw,
  redirect: 'follow'
};

fetch("https://api.shipengine.com/v1/labels", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://api.shipengine.com/v1/labels',
  'headers': {
    'Host': 'api.shipengine.com',
    'API-Key': '__YOUR_API_KEY_HERE__',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({"carrier_id":"se-123890","excluded_label_ids":[],"warehouse_id":"se-11921","ship_date":"2019-07-25T05:00:00.000Z"})

};
request(options, function (error, response) { 
  if (error) throw new Error(error);
  console.log(response.body);
});

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api.shipengine.com/v1/labels",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS =>"{\n  \"carrier_id\": \"se-123890\",\n  \"excluded_label_ids\": [],\n  \"warehouse_id\": \"se-11921\",\n  \"ship_date\": \"2019-07-25T05:00:00.000Z\"\n}",
  CURLOPT_HTTPHEADER => array(
    "Host: api.shipengine.com",
    "API-Key: __YOUR_API_KEY_HERE__",
    "Content-Type: application/json"
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

import requests

url = "https://api.shipengine.com/v1/labels"

payload = "{\n  \"carrier_id\": \"se-123890\",\n  \"excluded_label_ids\": [],\n  \"warehouse_id\": \"se-11921\",\n  \"ship_date\": \"2019-07-25T05:00:00.000Z\"\n}"
headers = {
  'Host': 'api.shipengine.com',
  'API-Key': '__YOUR_API_KEY_HERE__',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data = payload)

print(response.text.encode('utf8'))

require "uri"
require "net/http"

url = URI("https://api.shipengine.com/v1/labels")

https = Net::HTTP.new(url.host, url.port);
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Host"] = "api.shipengine.com"
request["API-Key"] = "__YOUR_API_KEY_HERE__"
request["Content-Type"] = "application/json"
request.body = "{\n  \"carrier_id\": \"se-123890\",\n  \"excluded_label_ids\": [],\n  \"warehouse_id\": \"se-11921\",\n  \"ship_date\": \"2019-07-25T05:00:00.000Z\"\n}"

response = https.request(request)
puts response.read_body

var client = new RestClient("https://api.shipengine.com/v1/labels");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("Host", "api.shipengine.com");
request.AddHeader("API-Key", "__YOUR_API_KEY_HERE__");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n  \"carrier_id\": \"se-123890\",\n  \"excluded_label_ids\": [],\n  \"warehouse_id\": \"se-11921\",\n  \"ship_date\": \"2019-07-25T05:00:00.000Z\"\n}",  ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\n  \"carrier_id\": \"se-123890\",\n  \"excluded_label_ids\": [],\n  \"warehouse_id\": \"se-11921\",\n  \"ship_date\": \"2019-07-25T05:00:00.000Z\"\n}");
Request request = new Request.Builder()
  .url("https://api.shipengine.com/v1/labels")
  .method("POST", body)
  .addHeader("Host", "api.shipengine.com")
  .addHeader("API-Key", "__YOUR_API_KEY_HERE__")
  .addHeader("Content-Type", "application/json")
  .build();
Response response = client.newCall(request).execute();

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://api.shipengine.com/v1/labels"
  method := "POST"

  payload := strings.NewReader("{\n  \"carrier_id\": \"se-123890\",\n  \"excluded_label_ids\": [],\n  \"warehouse_id\": \"se-11921\",\n  \"ship_date\": \"2019-07-25T05:00:00.000Z\"\n}")

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
  }
  req.Header.Add("Host", "api.shipengine.com")
  req.Header.Add("API-Key", "__YOUR_API_KEY_HERE__")
  req.Header.Add("Content-Type", "application/json")

  res, err := client.Do(req)
  defer res.Body.Close()
  body, err := ioutil.ReadAll(res.Body)

  fmt.Println(string(body))
}

#import <Foundation/Foundation.h>

dispatch_semaphore_t sema = dispatch_semaphore_create(0);

NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:@"https://api.shipengine.com/v1/labels"]
  cachePolicy:NSURLRequestUseProtocolCachePolicy
  timeoutInterval:10.0];
NSDictionary *headers = @{
  @"Host": @"api.shipengine.com",
  @"API-Key": @"__YOUR_API_KEY_HERE__",
  @"Content-Type": @"application/json"
};

[request setAllHTTPHeaderFields:headers];
NSData *postData = [[NSData alloc] initWithData:[@"{\n  \"carrier_id\": \"se-123890\",\n  \"excluded_label_ids\": [],\n  \"warehouse_id\": \"se-11921\",\n  \"ship_date\": \"2019-07-25T05:00:00.000Z\"\n}" dataUsingEncoding:NSUTF8StringEncoding]];
[request setHTTPBody:postData];

[request setHTTPMethod:@"POST"];

NSURLSession *session = [NSURLSession sharedSession];
NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request
completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
  if (error) {
    NSLog(@"%@", error);
  } else {
    NSHTTPURLResponse *httpResponse = (NSHTTPURLResponse *) response;
    NSError *parseError = nil;
    NSDictionary *responseDictionary = [NSJSONSerialization JSONObjectWithData:data options:0 error:&parseError];
    NSLog(@"%@",responseDictionary);
    dispatch_semaphore_signal(sema);
  }
}];
[dataTask resume];
dispatch_semaphore_wait(sema, DISPATCH_TIME_FOREVER);

import Foundation

var semaphore = DispatchSemaphore (value: 0)

let parameters = "{\n  \"carrier_id\": \"se-123890\",\n  \"excluded_label_ids\": [],\n  \"warehouse_id\": \"se-11921\",\n  \"ship_date\": \"2019-07-25T05:00:00.000Z\"\n}"
let postData = parameters.data(using: .utf8)

var request = URLRequest(url: URL(string: "https://api.shipengine.com/v1/labels")!,timeoutInterval: Double.infinity)
request.addValue("api.shipengine.com", forHTTPHeaderField: "Host")
request.addValue("__YOUR_API_KEY_HERE__", forHTTPHeaderField: "API-Key")
request.addValue("application/json", forHTTPHeaderField: "Content-Type")

request.httpMethod = "POST"
request.httpBody = postData

let task = URLSession.shared.dataTask(with: request) { data, response, error in 
  guard let data = data else {
    print(String(describing: error))
    return
  }
  print(String(data: data, encoding: .utf8)!)
  semaphore.signal()
}

task.resume()
semaphore.wait()

{
  "manifests": [
    {
      "manifest_id": "se-17618625",
      "form_id": "se-28529731",
      "created_at": "2019-07-12T13:37:39.050Z",
      "ship_date": "2019-07-25T05:00:00.000Z",
      "shipments": 100,
      "warehouse_id": "se-28529731",
      "submission_id": "9475711899564878915476",
      "carrier_id": "se-123890",
      "manifest_download": {
        "href": "http://api.shipengine.com/v1/labels/se-28529731"
      }
    }
  ]
}

{
  "manifests": [
    {
      "manifest_id": "se-17618625",
      "form_id": "se-28529731",
      "created_at": "2019-07-12T13:37:39.050Z",
      "ship_date": "2019-07-25T05:00:00.000Z",
      "shipments": 100,
      "warehouse_id": "se-28529731",
      "submission_id": "9475711899564878915476",
      "carrier_id": "se-123890",
      "manifest_download": {
        "href": "http://api.shipengine.com/v1/labels/se-28529731"
      }
    }
  ]
}

Group Labels into Multiple Manifests

If you have multiple outgoing shipments per day, you may want to group your available labels into more than one manifest. Use either the label_ids or excluded_label_ids properties to do this.

Info You can only use label_ids or excluded_label_ids when generating a manifest.

Example of `label_ids` property

Will only include the labels that are specified in the label_ids property. You no longer have to include the carrier_id, warehouse_id, or ship_date when using the label_ids property.

Example of `exclude_label_ids`property

This method will include all labels except for those you specify in the excluded_label_ids property.

POST /v1/manifests HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json

{
  "carrier_id": "se-123890",
  "excluded_label_ids": ["se-29602037", "se-29544722", "se-29475869"],
  "warehouse_id": "se-11921",
  "ship_date": "2019-07-25T05:00:00.000Z"
}

curl -iX POST https://api.shipengine.com/v1/manifests \
-H 'API-Key: __YOUR_API_KEY_HERE__' \
-H 'Content-Type: application/json' \
-d '{
  "carrier_id": "se-123890",
  "excluded_label_ids": ["se-29602037", "se-29544722", "se-29475869"],
  "warehouse_id": "se-11921",
  "ship_date": "2019-07-25T05:00:00.000Z"
}'

$headers = New-Object "System.Collections.Generic.Dictionary[[String],[String]]"
$headers.Add("Host", "api.shipengine.com")
$headers.Add("API-Key", "__YOUR_API_KEY_HERE__")
$headers.Add("Content-Type", "application/json")

$body = "{`n  `"carrier_id`": `"se-123890`",`n  `"excluded_label_ids`": [`"se-29602037`", `"se-29544722`", `"se-29475869`"],`n  `"warehouse_id`": `"se-11921`",`n  `"ship_date`": `"2019-07-25T05:00:00.000Z`"`n}"

$response = Invoke-RestMethod 'https://api.shipengine.com/v1/manifests' -Method 'POST' -Headers $headers -Body $body
$response | ConvertTo-Json

var myHeaders = new Headers();
myHeaders.append("Host", "api.shipengine.com");
myHeaders.append("API-Key", "__YOUR_API_KEY_HERE__");
myHeaders.append("Content-Type", "application/json");

var raw = JSON.stringify({"carrier_id":"se-123890","excluded_label_ids":["se-29602037","se-29544722","se-29475869"],"warehouse_id":"se-11921","ship_date":"2019-07-25T05:00:00.000Z"});

var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: raw,
  redirect: 'follow'
};

fetch("https://api.shipengine.com/v1/manifests", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://api.shipengine.com/v1/manifests',
  'headers': {
    'Host': 'api.shipengine.com',
    'API-Key': '__YOUR_API_KEY_HERE__',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({"carrier_id":"se-123890","excluded_label_ids":["se-29602037","se-29544722","se-29475869"],"warehouse_id":"se-11921","ship_date":"2019-07-25T05:00:00.000Z"})

};
request(options, function (error, response) { 
  if (error) throw new Error(error);
  console.log(response.body);
});

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api.shipengine.com/v1/manifests",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS =>"{\n  \"carrier_id\": \"se-123890\",\n  \"excluded_label_ids\": [\"se-29602037\", \"se-29544722\", \"se-29475869\"],\n  \"warehouse_id\": \"se-11921\",\n  \"ship_date\": \"2019-07-25T05:00:00.000Z\"\n}",
  CURLOPT_HTTPHEADER => array(
    "Host: api.shipengine.com",
    "API-Key: __YOUR_API_KEY_HERE__",
    "Content-Type: application/json"
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

import requests

url = "https://api.shipengine.com/v1/manifests"

payload = "{\n  \"carrier_id\": \"se-123890\",\n  \"excluded_label_ids\": [\"se-29602037\", \"se-29544722\", \"se-29475869\"],\n  \"warehouse_id\": \"se-11921\",\n  \"ship_date\": \"2019-07-25T05:00:00.000Z\"\n}"
headers = {
  'Host': 'api.shipengine.com',
  'API-Key': '__YOUR_API_KEY_HERE__',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data = payload)

print(response.text.encode('utf8'))

require "uri"
require "net/http"

url = URI("https://api.shipengine.com/v1/manifests")

https = Net::HTTP.new(url.host, url.port);
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Host"] = "api.shipengine.com"
request["API-Key"] = "__YOUR_API_KEY_HERE__"
request["Content-Type"] = "application/json"
request.body = "{\n  \"carrier_id\": \"se-123890\",\n  \"excluded_label_ids\": [\"se-29602037\", \"se-29544722\", \"se-29475869\"],\n  \"warehouse_id\": \"se-11921\",\n  \"ship_date\": \"2019-07-25T05:00:00.000Z\"\n}"

response = https.request(request)
puts response.read_body

var client = new RestClient("https://api.shipengine.com/v1/manifests");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("Host", "api.shipengine.com");
request.AddHeader("API-Key", "__YOUR_API_KEY_HERE__");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n  \"carrier_id\": \"se-123890\",\n  \"excluded_label_ids\": [\"se-29602037\", \"se-29544722\", \"se-29475869\"],\n  \"warehouse_id\": \"se-11921\",\n  \"ship_date\": \"2019-07-25T05:00:00.000Z\"\n}",  ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\n  \"carrier_id\": \"se-123890\",\n  \"excluded_label_ids\": [\"se-29602037\", \"se-29544722\", \"se-29475869\"],\n  \"warehouse_id\": \"se-11921\",\n  \"ship_date\": \"2019-07-25T05:00:00.000Z\"\n}");
Request request = new Request.Builder()
  .url("https://api.shipengine.com/v1/manifests")
  .method("POST", body)
  .addHeader("Host", "api.shipengine.com")
  .addHeader("API-Key", "__YOUR_API_KEY_HERE__")
  .addHeader("Content-Type", "application/json")
  .build();
Response response = client.newCall(request).execute();

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://api.shipengine.com/v1/manifests"
  method := "POST"

  payload := strings.NewReader("{\n  \"carrier_id\": \"se-123890\",\n  \"excluded_label_ids\": [\"se-29602037\", \"se-29544722\", \"se-29475869\"],\n  \"warehouse_id\": \"se-11921\",\n  \"ship_date\": \"2019-07-25T05:00:00.000Z\"\n}")

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
  }
  req.Header.Add("Host", "api.shipengine.com")
  req.Header.Add("API-Key", "__YOUR_API_KEY_HERE__")
  req.Header.Add("Content-Type", "application/json")

  res, err := client.Do(req)
  defer res.Body.Close()
  body, err := ioutil.ReadAll(res.Body)

  fmt.Println(string(body))
}

#import <Foundation/Foundation.h>

dispatch_semaphore_t sema = dispatch_semaphore_create(0);

NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:@"https://api.shipengine.com/v1/manifests"]
  cachePolicy:NSURLRequestUseProtocolCachePolicy
  timeoutInterval:10.0];
NSDictionary *headers = @{
  @"Host": @"api.shipengine.com",
  @"API-Key": @"__YOUR_API_KEY_HERE__",
  @"Content-Type": @"application/json"
};

[request setAllHTTPHeaderFields:headers];
NSData *postData = [[NSData alloc] initWithData:[@"{\n  \"carrier_id\": \"se-123890\",\n  \"excluded_label_ids\": [\"se-29602037\", \"se-29544722\", \"se-29475869\"],\n  \"warehouse_id\": \"se-11921\",\n  \"ship_date\": \"2019-07-25T05:00:00.000Z\"\n}" dataUsingEncoding:NSUTF8StringEncoding]];
[request setHTTPBody:postData];

[request setHTTPMethod:@"POST"];

NSURLSession *session = [NSURLSession sharedSession];
NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request
completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
  if (error) {
    NSLog(@"%@", error);
  } else {
    NSHTTPURLResponse *httpResponse = (NSHTTPURLResponse *) response;
    NSError *parseError = nil;
    NSDictionary *responseDictionary = [NSJSONSerialization JSONObjectWithData:data options:0 error:&parseError];
    NSLog(@"%@",responseDictionary);
    dispatch_semaphore_signal(sema);
  }
}];
[dataTask resume];
dispatch_semaphore_wait(sema, DISPATCH_TIME_FOREVER);

import Foundation

var semaphore = DispatchSemaphore (value: 0)

let parameters = "{\n  \"carrier_id\": \"se-123890\",\n  \"excluded_label_ids\": [\"se-29602037\", \"se-29544722\", \"se-29475869\"],\n  \"warehouse_id\": \"se-11921\",\n  \"ship_date\": \"2019-07-25T05:00:00.000Z\"\n}"
let postData = parameters.data(using: .utf8)

var request = URLRequest(url: URL(string: "https://api.shipengine.com/v1/manifests")!,timeoutInterval: Double.infinity)
request.addValue("api.shipengine.com", forHTTPHeaderField: "Host")
request.addValue("__YOUR_API_KEY_HERE__", forHTTPHeaderField: "API-Key")
request.addValue("application/json", forHTTPHeaderField: "Content-Type")

request.httpMethod = "POST"
request.httpBody = postData

let task = URLSession.shared.dataTask(with: request) { data, response, error in 
  guard let data = data else {
    print(String(describing: error))
    return
  }
  print(String(data: data, encoding: .utf8)!)
  semaphore.signal()
}

task.resume()
semaphore.wait()

Response with `exclude_label_ids`property

{
  "manifests": [
    {
      "manifest_id": "se-17618625",
      "form_id": "se-28529731",
      "created_at": "2019-07-12T13:37:39.050Z",
      "ship_date": "2019-07-25T05:00:00.000Z",
      "shipments": 100,
      "warehouse_id": "se-28529731",
      "submission_id": "9475711899564878915476",
      "carrier_id": "se-123890",
      "manifest_download": {
        "href": "http://api.shipengine.com/v1/labels/se-28529731"
      }
    }
  ]
}

{
  "manifests": [
    {
      "manifest_id": "se-17618625",
      "form_id": "se-28529731",
      "created_at": "2019-07-12T13:37:39.050Z",
      "ship_date": "2019-07-25T05:00:00.000Z",
      "shipments": 100,
      "warehouse_id": "se-28529731",
      "submission_id": "9475711899564878915476",
      "carrier_id": "se-123890",
      "manifest_download": {
        "href": "http://api.shipengine.com/v1/labels/se-28529731"
      }
    }
  ]
}