# Retrieve a shipment carrier

Operation ID: `getShipmentCarrier`

Group: Inventory › Shipment Carriers

[Open in the interactive reference](https://docs.api.lensing.ai/lensing/v1/endpoints/getShipmentCarrier)

`GET /inventory/shipment-carriers/{id}`

Read-only: Reads and returns; changes nothing.

Retrieves a shipment carrier. The response gives the carrier's name, whether it is active, and the vendor it bills through.

GET inventory/shipment-carriers and POST inventory/shipment-carriers/search return the same fields.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `Api-Version` | header | string · v1 | yes | The API version this request targets, named by its public identifier. Required on every request; omitting it, or naming a version this company does not have, is answered with 400. This document describes version `v1`. |
| `id` | path | string | yes | The unique identifier of the shipment carrier you want to retrieve. |

## Response

`200` Success

Under `data` (getShipmentCarrierOutput):

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | yes | The unique identifier for the shipment carrier. Example: `"5c2e9a71-3f48-4b02-8d6e-9a1c74b0e332"`. |
| `name` | string | yes | The name of the carrier, for example 'DHL Express'. Names are not unique, so use id to address one carrier. Example: `"DHL Express"`. |
| `active` | boolean | no | Whether the carrier can be selected on new shipments. Absent on carriers created before the active flag existed. Example: `true`. |
| `vendorId` | string | no | The unique identifier for the vendor this carrier bills through. Absent when the carrier has no vendor. See id on GET accounting/vendors/:id. Example: `"d4a71e08-6b95-4f23-b7c1-52e08a936d47"`. |
| `vendorName` | string | no | The name of the vendor this carrier bills through. Absent when the carrier has no vendor. It is resolved from the vendor at read time and is not stored on the carrier. Example: `"DHL International GmbH"`. |
| `lastModifiedDate` | date-time | no | The date and time the carrier record last changed, in UTC. Format YYYY-MM-DDTHH:mm:ss.sssZ. Example: `"2026-05-12T09:30:00.000Z"`. |

```json
{
  "data": {
    "id": "5c2e9a71-3f48-4b02-8d6e-9a1c74b0e332",
    "name": "DHL Express",
    "active": true,
    "vendorId": "d4a71e08-6b95-4f23-b7c1-52e08a936d47",
    "vendorName": "DHL International GmbH",
    "lastModifiedDate": "2026-05-12T09:30:00.000Z"
  },
  "diagnostics": [
    {
      "code": "<code>",
      "message": "<message>",
      "severity": "error",
      "path": [
        "<path>"
      ],
      "details": "<details>"
    }
  ]
}
```

## Errors

| Code | Status |
| --- | --- |
| `NOT_FOUND` | 400 |

## Statuses

- `400` — Invalid request or business failure. Codes: NOT_FOUND
- `401` — The request carries no valid access token.
- `403` — Not authorized
- `404` — Not found
- `429` — Too many requests from this client address. The response has no body and no `Retry-After` header.
- `500` — Internal server error