# Services

Service (vended service) management operations.
Services represent non-carrier vendor work (drayage, customs, warehousing).


## Filter services

 - [POST /services/filter](https://docs.mvmnt.io/apis/openapi/services/filterservices.md): Search for services using filter criteria.

## Common Filters

- By shipment: { "filter": { "shipmentId": { "equalTo": "uuid" } } }
- By vendor: { "filter": { "vendorId": { "equalTo": "uuid" } } }
- Awaiting invoice: { "filter": { "status": { "equalTo": "AWAITING_INVOICE" } } }

## Create a service

 - [POST /services](https://docs.mvmnt.io/apis/openapi/services/createservice.md): Create a new service for a shipment.

## What happens

- Service is created for the specified shipment
- Vendor is associated with the service
- Charges are recorded

## Note

Services are typically created as part of shipment creation.
Use this endpoint to add additional services to an existing shipment.

## Get a service

 - [GET /services/{id}](https://docs.mvmnt.io/apis/openapi/services/getservice.md): Retrieve a service by ID.

The response includes vendor info and charges.

## Update a service

 - [PATCH /services/{id}](https://docs.mvmnt.io/apis/openapi/services/updateservice.md): Update service fields.

Note: Status changes happen automatically based on billing workflow.

## Delete a service

 - [DELETE /services/{id}](https://docs.mvmnt.io/apis/openapi/services/deleteservice.md): Soft delete a service.

## Prerequisites

- Service must not be paid