# Returns the shipment carrier with the given identifier.

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

Group: Inventory › Shipment Carriers · Operation ID: `getShipmentCarrier`

Returns the same fields as GET inventory/shipment-carriers and POST inventory/shipment-carriers/search. vendorId and vendorName are present only when the carrier is linked to a vendor.

[Open in the interactive reference](https://docs.api.lensing.ai/?op=getShipmentCarrier)

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `Api-Version` | header | `"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 for the shipment carrier to return. |

## Response

`200` Success

Under `data` (getShipmentCarrierOutput):

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | yes | The unique identifier for the shipment carrier. |
| `name` | string | yes | The name of the carrier, for example 'DHL Express'. Names are not unique, so use id to address one carrier. |
| `active` | boolean | no | Whether the carrier can be selected on new shipments. Absent on carriers created before the active flag existed. |
| `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. |
| `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. |
| `lastModifiedDate` | string (date-time) | no | The date and time the carrier record last changed, in UTC. Format YYYY-MM-DDTHH:mm:ss.sssZ. |

## Errors

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

## Statuses

- `400` — Invalid request or business failure. Codes: NOT_FOUND
- `401` — Missing or invalid access token
- `403` — Not authorized
- `404` — Not found
- `429` — Too many requests
- `500` — Internal server error