Create Manifests

Learn what manifests are, why they're important, and how to create one for USPS.

What are Manifests, End of Day, or Scan Forms?

Many manifests are sent electronically to the carrier when you create a label, and often physical manifests are not necessary. Carriers receive the package details, shipping date, and other information that help them plan your package's delivery when you create a label.

However, some providers, like USPS require manifests when shipping large numbers of packages. Think about how long it would take for a delivery driver to arrive, pick up 100 packages, and individually scan each of them.

A manifest exists so the carrier can scan the manifest and check in all the packages being shipped.

When Do You Make a Manifest?

Manifests exist to increase the efficiency of a postal worker and warehouse staff. 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.

Model Basics

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
$date$

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.

/v1/manifests

curl '$apiUrl$/v1/manifests' -X POST \
  -H "Content-type: application/json" \
  -H $apiAuth$ \
  -d '
{
  "carrier_id": "#stampsId#",
  "excluded_label_ids": [],
  "warehouse_id": "se-11921",
  "ship_date": "#shipDate#"
}'
{
  "form_id": "se-551",
  "manifest_download": {
      "href": "$apiUrl$/v1/downloads/1/aksjdifahffj2_2/manifest-551.pdf"
    }
  }
}

Create Manifests


Learn what manifests are, why they're important, and how to create one for USPS.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.