# List reasons for shipment

`GET /client_api/v2/reason_for_shipments`

Why goods can be moving, for customs. A quote's `reason_for_shipment_id` comes from here.

## Returns

Returns a list of reason for shipments.

- `reason_for_shipments` (array of objects, required): The reasons for shipment, by name.
  - `id` (integer, required): The reason's id, for a quote's `reason_for_shipment_id`.
  - `enabled` (boolean, required): Whether the reason is switched on.
  - `name` (string, required): The reason, as customs sees it.
  - `product_identifiers_required` (boolean, required): `true` when each item needs a product code, such as a SKU, model number or barcode.
  - `return` (boolean, required): `true` when the goods are coming back, for example after a repair.
  - `sort_index` (integer, required): Where the reason sits in a list shown to people.

## Errors

- `401 Unauthorized`: The token is missing, expired or invalid. Sign in again.

## Example request (curl)

```bash
curl -X GET "https://sandbox-api.vatit-stream.com/client_api/v2/reason_for_shipments" \
  -H "Authorization: Bearer $API_TOKEN"
```

## Example response (200)

```json
{
  "reason_for_shipments": [
    {
      "id": 9,
      "enabled": true,
      "name": "Commercial sale",
      "product_identifiers_required": true,
      "return": false,
      "sort_index": 1
    },
    {
      "id": 2,
      "enabled": true,
      "name": "Documents",
      "product_identifiers_required": false,
      "return": false,
      "sort_index": 3
    },
    {
      "id": 1,
      "enabled": true,
      "name": "Gift",
      "product_identifiers_required": false,
      "return": false,
      "sort_index": 2
    },
    {
      "id": 10,
      "enabled": true,
      "name": "Return for repair",
      "product_identifiers_required": true,
      "return": false,
      "sort_index": 4
    }
  ]
}
```