Reprint a Manifest

HTTP Request

GET /v1/manifests/{manifestId}

Summary

This operation reprints a manifest for which the initial Create Manifest request was successful but the response did not save properly.

Important: This operation does not apply to Newgistics or PB Presort.

Things to Consider

  1. Do not use this operation in the following cases:
  2. This operation does not apply to Newgistics or PB Presort.

Request URIs

Sandbox: https://api-sandbox.pitneybowes.com/shippingservices/v1/manifests/{manifestId}
Production: https://api.pitneybowes.com/shippingservices/v1/manifests/{manifestId}

Path Parameter

Name Description
manifestId Required. The unique ID of the manifest that was assigned when it was created.

Request Header

Name
Description
Authorization Required. OAuth token generated using the Generate an OAuth Token API.
X-PB-UnifiedErrorStructure Recommended. Set this to true to use the standard error object if an error occurs.

Response Elements

Important

The response returns a Manifest Object. The following table describes all possible fields in a Manifest Object. Some fields and values do not apply to this operation and are marked accordingly.

Name Data Type Description
carrier String

Required. The carrier to which the manifest applies.

For some operations, this field is not present in the response.

Valid values:

  • USPS
  • NEWGISTICS - Valid only in a Create Manifest request
  • PBPresort - Valid only in a Create Manifest request
submissionDate String

Required. The time and date the shipments are to be tendered to the carrier. The time and date must be in UTC/GMT and in one of the following formats:

  • YYYY-MM-DD
  • YYYY-MM-DD HH:mm:ss
  • YYYY-MM-DD HH:mm:ss.SSS
fromAddress Address Object

Conditional. The shipment origin address.

Required for:

inductionPostalCode String

Conditional. Postal code where the shipments are tendered to the carrier.

This field does not apply to Newgistics manifests.

parcelTrackingNumbers Array[String]

Identifies shipments by their tracking numbers. List one or more shipment tracking numbers, separated by commas.

This field does not apply to Newgistics manifests.

parameters Array[Object]

Conditional. Each object in the array defines a different manifest parameter. This field is used only in the request and is not returned in the response.

Required for Newgistics manifests (closeouts).

        name String The name of the manifest parameter.
        value String The value of the manifest parameter.
manifestId String Response Only. The unique manifest ID.
manifestTrackingNumber String Response Only, USPS Only. The manifest tracking number.
documents Array[Documents Object]

Response Only. The manifest.

This field is not returned for a Newgistics manifest.

Sample Request

curl -X GET .../v1/manifests/9475709899581000196258 \
-H "Authorization: Bearer <oauth_token>" \
-H "X-PB-UnifiedErrorStructure: true"

Sample Response

{
    "carrier": "USPS",
    "submissionDate": "2017-08-03 00:00:00.0",
    "fromAddress": { ... },
    "parcelTrackingNumbers": [
        "9405509898641491052445"
        "9405509898641491052513",
        "9405509898641491052520"
    ],
    "manifestId": "9475709899581000196258",
    "manifestTrackingNumber": "9475709899581000196258",
    "documents": [ {
        "type": "MANIFEST",
        "contentType": "URL",
        "contents": "https://.../usps/872060188/scanform/c860208d886e4fa581b29063c4e7b3de.pdf"
    } ]
}

Error Codes

For a list of all PB Shipping APIs error codes, please see Error Codes.