Skip to content
MothershipDevelopers

API referenceInvoices

List a shipment's invoices

Lists all invoices associated with a shipment.

GET/invoices/by_shipment_id/{shipmentId}
Environment
https://sandbox.api.mothership.com/beta
curl --request GET \
  --url 'https://sandbox.api.mothership.com/beta/invoices/by_shipment_id/MS5016101' \
  --header "Authorization: Bearer $MOTHERSHIP_API_TOKEN" \
  --header 'Accept: application/json'
Reads your token from $MOTHERSHIP_API_TOKEN
Response
{
: {
: [
{
: "3f1c2a9e-5b7d-4e8a-9c61-2d4f8b0e7a15",
: "2026-03-19T17:00:00.000Z"
}
],
: true,
: 1,
: 10,
: 1,
: 2
}
}

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

Authorization

Authorization: Bearer <token>

Your sandbox API token. See Authentication.

Path parameters

  • shipmentIdstringRequired

    The shipment's public reference number, such as MS5016101, or its internal UUID.

Query parameters

  • pagestring

    Pagination cursor. Leave it out on the first call, then pass the nextPage value from the previous response to get the next page.

  • limitstring

    Number of results to return, from 1 to 100. Defaults to 10.

Responses

    • dataobjectRequired
      • invoicesarray of objectsRequired
      • hasMorebooleanRequired

        True if there are more records to fetch.

      • totalnumber

        The total number of invoices that are modified on or after the date.

      • limitnumber

        Number of results requested for this page. The last page can return fewer.

      • currentPagenumber

        Index of this page of results.

      • nextPagenumber

        Index of the next page of results, if there is one.

        nullable

What's next

Invoice line items

What each line item type means.