DHL eCommerce Americas Manifest API Virtual Sandbox

Automate package manifest creation and retrieval for DHL eCommerce Americas shipments.

The DHL eCommerce Americas Manifest API enables developers to generate manifests for specific packages or bulk-process open items. It supports creating new manifest requests and retrieving details for previously submitted requests, facilitating seamless integration with DHL's shipping infrastructure.

Use this hosted sandbox to simulate DHL eCommerce Americas Manifest API APIs without authentication, API keys, or extra dependencies. Point your code or SDK to the Beeceptor base URL, preferably through an environment variable or feature flag, and switch back to the production API when ready. This keeps your integration code consistent across local development, QA, demos, and production.

Use cases:

Use this sandbox to validate manifest creation workflows, test payload structures for specific package identifiers, verify bulk closeout logic for open items, and handle API response states for successful manifest generation or error scenarios.

DHL eCommerce Americas Manifest API virtual sandbox is up and running!

Use this sandbox URL as the API base in your code to simulate DHL eCommerce Americas Manifest API responses instantly.

`https://dhl-manifest.mock.beeceptor.com`

Manifest(2 operations)

POST

/shipping/v4/manifest

Use this request to create a new manifest for specific packages. Here's the package identifiers supported in the request: - `packageIds` - `products` - `dhlPackageIds`

Header Name	Example
`User-Agent`	`"fugiat commodo irure"`

Request Payload

{
  "pickup": "5234567",
  "manifests": [
    {
      "packageIds": [
        "V4API1684957273459",
        "V4API1684957273460"
      ]
    }
  ]
}

Response Payload

{
  "timestamp": "2025-10-30T17:49:07.856Z",
  "requestId": "4c35l2c8-es71-94b8-8bfd-82269d9k0448",
  "link": "https://api-sandbox.dhlecs.com/shipping/v4/manifest/5234567/4c35l2c8-es71-94b8-8bfd-82269d9k0448"
}

{
  "invalidParams": [
    {
      "name": "packageIds",
      "path": "/manifests/0/packageIds",
      "reason": "expected type: JSONArray, found: String"
    },
    {
      "name": "packageIds",
      "path": "/manifests/0/packageIds",
      "reason": "expected type: JSONArray, found: String"
    }
  ],
  "title": "Static Validation Failed",
  "type": "https://api-sandbox.dhlecs.com/docs/errors/400.0404001"
}

{
  "title": "No credentials provided",
  "type": "https://api-sandbox.dhlecs.com/docs/errors/401.0000008"
}

{
  "title": "Internal gateway server error",
  "type": "https://api-sandbox.dhlecs.com/docs/errors/500.0000002"
}

GET

/shipping/v4/manifest/{pickup}/{requestId}

Use this request to download a manifest or retrieve a manifest for a request that was submitted previously. Here's the identifier used to retrieve a manifest: - `requestId` The error object in the manifestSummary can have the following errors: - 001 Package not found - 002 Package already mani

Header Name	Example
`User-Agent`	`"dolor proident sit dolore in"`

Request Payload

Response Payload

{
  "timestamp": "2025-10-31T15:21:55.568Z",
  "pickup": "5234567",
  "requestId": "4a35b2c8-kb71-44b8-8bfd-82462d9b0598",
  "status": "COMPLETED",
  "link": "https://api-sandbox.dhlecs.com/shipping/v4/manifest/5234567/4a35b2c8-kb71-44b8-8bfd-82462d9b0598",
  "manifests": [
    {
      "createdOn": "2025-10-31T13:41:22.700Z",
      "manifestId": "52345675103113412390",
      "distributionCenter": "USEWR1",
      "isInternational": false,
      "total": 1,
      "manifestData": "data",
      "encodeType": "BASE64",
      "format": "PDF"
    }
  ],
  "manifestSummary": {
    "total": 1,
    "invalid": {
      "total": 0
    }
  }
}

{
  "invalidParams": [
    {
      "name": "packageIds",
      "path": "/manifests/0/packageIds",
      "reason": "expected type: JSONArray, found: String"
    },
    {
      "name": "packageIds",
      "path": "/manifests/0/packageIds",
      "reason": "expected type: JSONArray, found: String"
    },
    {
      "name": "packageIds",
      "path": "/manifests/0/packageIds",
      "reason": "expected type: JSONArray, found: String"
    },
    {
      "name": "packageIds",
      "path": "/manifests/0/packageIds",
      "reason": "expected type: JSONArray, found: String"
    },
    {
      "name": "packageIds",
      "path": "/manifests/0/packageIds",
      "reason": "expected type: JSONArray, found: String"
    }
  ],
  "title": "Static Validation Failed",
  "type": "https://api-sandbox.dhlecs.com/docs/errors/400.0404001"
}

{
  "title": "No credentials provided",
  "type": "https://api-sandbox.dhlecs.com/docs/errors/401.0000008"
}

{
  "title": "Content-Type header requested is not supported or header is not present",
  "type": "https://api-sandbox.dhlecs.com/docs/errors/415.0000001"
}

{
  "title": "Internal gateway server error",
  "type": "https://api-sandbox.dhlecs.com/docs/errors/500.0000002"
}

Service Homepage: developer.dhl.com/api-reference/manifest-dhl-ecommerce-americas#reference-docs-section

dhlshippinglogisticsmanifestecommerce