# Shipment

The following chapter will give you an overview about the shipment endpoints and their function.

## Lookup for shipments

 - [POST /cargosoft/shipment/lookup](https://api-cargosoft.redocly.app/2025.1/openapi/shipment/lookup.md): This endpoint looks up shipments. The result should be limit by using search criterias in the request body. For a complete list of search criteria see the ShipmentIdentifier enumeration below. Depending on the search criteria you will receive zero up to n shipments.

## Retrieve airfreight shipment main carriage

 - [GET /cargosoft/shipment/{id}/airmaincarriage](https://api-cargosoft.redocly.app/2025.1/openapi/shipment/retrieveairmaincarriage.md): Retrieve the airfreight main carriage of the shipment with additional details. The CargoSoft Shipment ID is needed to retrieve the main carriage.

## Retrieve shipment

 - [GET /cargosoft/shipment/{id}](https://api-cargosoft.redocly.app/2025.1/openapi/shipment/retrievebyid.md): Retrieve a specific shipment with the CargoSoft database id.

## Retrieve shipment events

 - [GET /cargosoft/shipment/{id}/events](https://api-cargosoft.redocly.app/2025.1/openapi/shipment/retrieveevents.md): This endpoint retrieves all events of the shipment. To retrieve the events, the shipment id is needed. It is possible that not all events are included in the response because they are not entered or know in the shipment unitil now. To retrive the shipment id, use the lookup endpoint of this chapter.

## Retrieve seafreight shipment main carriage

 - [GET /cargosoft/shipment/{id}/seamaincarriage](https://api-cargosoft.redocly.app/2025.1/openapi/shipment/retrieveseamaincarriage.md): Retrieve the main carriage of the shipment with additional details.

## Create a shipment event

 - [POST /cargosoft/shipment/{shipmentId}/event](https://api-cargosoft.redocly.app/2025.1/openapi/shipment/create.md): Create a shipment event of the given event type.

## Update a shipment event

 - [PUT /cargosoft/shipment/{shipmentId}/event/{id}](https://api-cargosoft.redocly.app/2025.1/openapi/shipment/update.md): Update the event of the given event type.