# Line Items

## Create Line Item

```shell
curl "https://example.com/api/v2/line_items"
  -X POST
  -d token=abc123
  -d data[attributes][order_id]=1
  -d data[attributes][variant_id]=1
  -d data[attributes][quantity]=1
```

```json
{
  "data": {
    "attributes": {
      "additional_tax_total": "0",
      "adjustment_total": "0.0",
      "amount": "10.0",
      "cost_price": "17.0",
      "currency": "CAD",
      "display_amount": "$10.00 CAD",
      "display_price": "$10.00 CAD",
      "display_total": "$10.00 CAD",
      "order_id": 1,
      "price": "10.0",
      "quantity": 1,
      "total": "10.0",
      "variant_id": 1
    },
    "relationships": {
      "order": {
        "data": {
          "type": "spree_orders"
        }
      },
      "variant": {
        "data": {
          "type": "spree_variants"
        }
      }
    },
    "type": "spree_line_items"
  }
}
```

This endpoint allows you add a variant to a users order by creating a line item.

### When Out of Range

> Quantity is out of range.

```shell
curl "https://example.com/api/v2/line_items"
  -X POST
  -d token=abc123
  -d data[attributes][order_id]=1
  -d data[attributes][variant_id]=1
  -d data[attributes][quantity]=100000000000
```

```json
{
  "errors": [
    {
      "code": "400",
      "detail": "Quantity is too High",
      "meta": {},
      "status": "Bad Request",
      "title": "The quantity that you have submitted is astronomically high, please tone it down a bit."
    }
  ]
}
```

When requesting an insanely large amount of variants to be added to your order, this will result in an error.

### When a Variant or an Order Could Not be Found

> Order could not be found.

```shell
curl "https://example.com/api/v2/line_items"
  -X POST
  -d token=abc123
  -d data[attributes][order_id]=0
  -d data[attributes][variant_id]=1
  -d data[attributes][quantity]=1
```

```json
{
  "errors": [
    {
      "code": "400",
      "detail": "Record Not Found",
      "meta": {},
      "status": "Bad Request",
      "title": "One of the records that you were looking for could not be found. Please check to see if the record exists or if you're permitted to read it"
    }
  ]
}
```

Sometimes, you'll submit a bad variant id or order id.
When this happens, you'll receive an error because of it.

### When the Product is Out of Stock

> Product is out of stock.

```shell
curl "https://example.com/api/v2/line_items"
  -X POST
  -d token=abc123
  -d data[attributes][order_id]=1
  -d data[attributes][variant_id]=1
  -d data[attributes][quantity]=1
```

```json
{
  "errors": [
    {
      "code": "400",
      "detail": "Product is out of Stock",
      "meta": {},
      "status": "Bad Request",
      "title": "This product is out of stock for the selected quantity."
    }
  ]
}
```

Sometimes, there's just not going to be any left in stock.
This can happen for both two reasons:

1. The variant is tracking inventory and its stock items `count_on_hand`s have all reached 0.
2. The variant is not backorderable.

If both of these conditions are met, then you will reveice an out of stock error.