API referenceDocuments

List shipment documents

Generates URLs for a shipment's documents, such as the bill of lading and proof of delivery, when they are available.

GET/documents/{shipmentId}

https://sandbox.api.mothership.com/beta

curl --request GET \
  --url 'https://sandbox.api.mothership.com/beta/documents/MS5016101' \
  --header "Authorization: Bearer $MOTHERSHIP_API_TOKEN" \
  --header 'Accept: application/json'

Reads your token from $MOTHERSHIP_API_TOKEN

Response

{

: [

{

: "billOfLading",

: "https://s3-us-west-1.amazonaws.com/mothership-shipments-bill-of-lading/MS5016101.pdf",

: "2026-03-19T17:00:00.000Z"

}

]

}

Hover a key to see what it means. Click it to jump to the field.

Document URLs expire at expiresAt. Call this endpoint again for a fresh URL rather than storing one. To hear when a document is first attached or replaced, subscribe to the document webhook events.

Authorization

Authorization: Bearer <token>

Your sandbox API token. See Authentication.

Path parameters

shipmentIdstringRequired
ID of the shipment to list documents for.

Responses

- dataarray of objectsRequired
  typestringRequired
  Type of document
  billOfLadingcertificateOfInsurancedeliveryReceiptproofOfDelivery
  urlstringRequired
  URL of the document.
  expiresAtstring<date-time>Required
  When the document URL expires, as an ISO 8601 date-time.

What's next

Webhooks

Hear about billOfLading.created and the other document events as they happen.