---
title: "Create image of shipment document."
method: POST
path: "/api/v4/capacityproviders/ltl/shipments/images"
tags: ["LTL: Push Imaging"]
---

# Create image of shipment document.

`POST /api/v4/capacityproviders/ltl/shipments/images`

## Request

- Base URL: `https://na12.api.project44.com`
- URL: `https://na12.api.project44.com/api/v4/capacityproviders/ltl/shipments/images`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `/api/v4/oauth2/token`
- TypeScript: <https://skmtc.dev/project44/apis/project44-rest-api/docs/api/v4/capacityproviders/ltl/shipments/images/post.ts> (a function with typed inputs; its response is checked against the schema)

<h4><b>Required Fields</h4></b>
<ul><li><b>  customerAccount: </b></li><ul><li> accountIdentifier </li></ul><li><b>  carrierIdentifier: </b></li><ul><li> type </li><li> value </li></ul><li> imageFormat </li><li> documentType </li><li><b>  imagePages: </b></li><ul><li> imageUrl (if no imageData provided)</li><li> imageData (if no imageUrl provided)</li><li> pageNumber (if more then one page provided) </li></ul></ul>

## Request body

- ShipmentImage
  - `carrierIdentifier` CapacityProviderIdentifier: A capacity provider identifier object.
    - `type` 'SCAC' | 'DOT_NUMBER' | 'MC_NUMBER' | 'P44_EU' | 'SYSTEM' | 'P44_GLOBAL' | 'VAT': Capacity provider identifier type.
    - `value` string: Capacity provider identifier value.
  - `customerAccount` CustomerAccount
    - `accountIdentifier` string: The account identifier of the customer to whom this shipment belongs. This will be used to identify the mutual customer in project44's system.
  - `documentType` 'BILL_OF_LADING' | 'DELIVERY_RECEIPT' | 'WEIGHT_CERTIFICATE' | 'INVOICE' | 'INSPECTION_CERTIFICATE' | 'LETTER_OF_AUTHORIZATION' | 'LUMPER_CERTIFICATE' | 'PACKING_SLIP': A code for this image's document type.
  - `imageFormat` 'PDF' | 'TIF' | 'PNG' | 'GIF' | 'JPG': A code for this image's format.
  - `imagePages` ShipmentImagePage[]: Images of the pages that comprise a document (min:1, max:25).
    - `imageData` string: The Base64 encoded image contents. This or imageUrl may be populated but not both.
    - `imageUrl` string: The web URL for accessing this image. This or imageData may be populated but not both.
    - `pageNumber` integer: The index of the image page in the list of image pages that comprise a document for the shipment.

## Response `202`

Accepted

## Other responses

- `400`: Invalid request
- `401`: Invalid or missing credentials
- `403`: User not authorized to perform this operation

---

[API](https://skmtc.dev/project44/apis/project44-rest-api.md) - [All operations](https://skmtc.dev/project44/apis/project44-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/project44/apis/project44-rest-api/revisions/cdf9675e2294?raw)