manifests

Create manifest

Changed on Oct 22, 2026

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.

post/v1/manifests

Request

Base URL: https://api.shipengine.com
URL: https://api.shipengine.com/v1/manifests
Auth: API key in header API-Key

Request body

Example request

{
  "carrier_id": "se-28529731",
  "excluded_label_ids": [
    "se-28529731"
  ],
  "label_ids": [
    "se-28529731"
  ],
  "warehouse_id": "se-28529731",
  "ship_date": "2018-09-23T15:00:00.000Z"
}

Response

The request was a success.

manifest_idstring required

A string that uniquely identifies a ShipEngine resource, such as a carrier, label, shipment, etc.

form_idstring required

A string that uniquely identifies a ShipEngine resource, such as a carrier, label, shipment, etc.

created_atstring date-time required

The date-time that the manifest was created

ship_datestring date-time required

The date-time that the manifests shipments will be picked up

shipmentsinteger required

The number of shipments that are included in this manifest

warehouse_idstring required

A string that uniquely identifies a ShipEngine resource, such as a carrier, label, shipment, etc.

submission_idstring required

A string that uniquely identifies the submission

carrier_idstring required

A string that uniquely identifies a ShipEngine resource, such as a carrier, label, shipment, etc.

label_idsSeId[]

An array of the label ids used in this manifest.

request_idstring uuid required

A UUID (a.k.a. GUID) that uniquely identifies a resource

Example response

{
  "manifests": [
    {
      "manifest_id": "se-28529731",
      "form_id": "se-28529731",
      "created_at": "2019-07-12T13:37:39.050Z",
      "ship_date": "2019-07-12T13:37:39.050Z",
      "shipments": 100,
      "label_ids": [
        "se-28529731"
      ],
      "warehouse_id": "se-28529731",
      "submission_id": "9475711899564878915476",
      "carrier_id": "se-28529731",
      "manifest_download": {
        "href": "https://example.com/resource"
      }
    }
  ],
  "manifest_requests": [
    {
      "manifest_request_id": "se-28529731"
    }
  ],
  "manifest_id": "se-28529731",
  "form_id": "se-28529731",
  "created_at": "2019-07-12T13:37:39.050Z",
  "ship_date": "2019-07-12T13:37:39.050Z",
  "shipments": 100,
  "warehouse_id": "se-28529731",
  "submission_id": "9475711899564878915476",
  "carrier_id": "se-28529731",
  "manifest_download": {
    "href": "https://example.com/resource"
  },
  "label_ids": [
    "se-28529731"
  ],
  "request_id": "aa3d8e8e-462b-4476-9618-72db7f7b7009",
  "errors": [
    {
      "error_source": "shipengine",
      "error_type": "validation",
      "error_code": "invalid_field_value",
      "message": "Body of request cannot be null.",
      "carrier_id": "se-28529731",
      "carrier_code": "dhl_express",
      "field_name": "shipment.ship_to.phone_number"
    }
  ]
}

Changes

Oct 22, 2026e998dffc42be Revision changes
- warning
  added the new bring_your_own_label_not_supported enum value to the /// response property for the response status
- warning
  added the new bring_your_own_label_not_supported enum value to the // response property for the response status
- warning
  added the new bring_your_own_label_not_supported enum value to the // response property for the response status
- warning
  added the new multiple_sales_orders enum value to the /// response property for the response status
- warning
  added the new multiple_sales_orders enum value to the // response property for the response status
- warning
  added the new multiple_sales_orders enum value to the // response property for the response status
- warning
  added the new sales_order_link_required enum value to the /// response property for the response status
- warning
  added the new sales_order_link_required enum value to the // response property for the response status
- warning
  added the new sales_order_link_required enum value to the // response property for the response status
Oct 9, 2026020f57d6f5b8 Revision changes
- breaking
  the //// response's property type changed from no type to string for status
- breaking
  the /// response's property type changed from no type to string for status
- breaking
  the // response's property type changed from no type to string for status
- breaking
  the // response's property type changed from no type to object for status
- breaking
  the / response's property type changed from no type to object for status
- breaking
  the / response's property type changed from no type to object for status
- warning
  added the new completed enum value to the /// response property for the response status
- warning
  added the new in_progress enum value to the /// response property for the response status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  removed from the // response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the /// response property allOf list for the response status
- info
  removed from the //// response property allOf list for the response status
- info
  removed from the // response property allOf list for the response status
- info
  the //// response's property pattern ^se(-[a-z0-9]+)+$ was added for the status
- info
  the // response's property pattern ^se(-[a-z0-9]+)+$ was added for the status
- info
  added the required property /// to the response with the status
- info
  added the required property /// to the response with the status
- info
  added the required property /// to the response with the status
- info
  added the required property /// to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status

Operation history (4 revisions)