# Create Shipment Exception

**POST /shipment_exceptions**

Create a Shipment Exception for a Shipment

* Clients can create shipment exceptions of a single type currently:`requested_hold_to_collect` 

* A shipment must have a `pending` or `confirmed` status to create a `requested_hold_to_collect` shipment exception. 

* `hold_until` date cannot be greater than 30 days from the associated shipment's `created_at` timestamp.


## Servers
- https://api.arta.io: https://api.arta.io ()



## Parameters
### Headers
- **Authorization** (string)
  Authorize your API calls with an Arta API token



### Body: application/json (object)

- **shipment_exception** (object)



## Responses
### 201
Successful response
#### Headers
- **content-type** (string)

- **x-arta-request-id** (string)
  A unique identifier for the Arta API call

#### Body: application/json (object)
- **created_at** (string(date-time))
  A NaiveDatetime-formatted timestamp describing when the exception was created with microsecond precision
- **exception_type_label** (string | null)
  An additional label providing context about the exception type (optional)
- **hold_until** (string | null)
  The date the shipment will be held until
- **id** (string(uuid))
  The id of the exception in UUID format
- **package_id** (integer(int64) | null)
  The package associated with this exception (optional)
- **resolution** (string | null)
  A brief description of the method by which this exception was resolved
- **shipment_id** (string(uuid))
  The id of the shipment associated with this exception
- **source** (string)
  The source of the exception
- **status** (string)
  The current status for this exception
- **type** (string)
  The type of exception
- **updated_at** (string(date-time))
  A NaiveDatetime-formatted timestamp describing when the exception was last updated with microsecond precision


[Powered by Bump.sh](https://bump.sh)