> For the complete documentation index, see [llms.txt](https://vu-custom.gitbook.io/vu-custom/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://vu-custom.gitbook.io/vu-custom/admin-api/order-lines/retrieve-a-list-of-order-lines.md).

# Retrieve a list of order lines

Method : <mark style="color:green;">**GET**</mark>

{% code fullWidth="false" %}

```url
https://os.vucustom.com/api/v1/order_lines?status=&with_tags=&without_tags=&limit&since_idmber=
```

{% endcode %}

URL Parameters

<table><thead><tr><th width="187">Field Name</th><th>Description</th></tr></thead><tbody><tr><td>status</td><td>Filter order lines by their current status. Must be one of VU's standard order statuses</td></tr><tr><td>with_tags</td><td>Comma-separated list of tags. Returns order lines that have ALL specified tags</td></tr><tr><td>without_tags</td><td>Comma-separated list of tags. Returns order lines that have NONE of the specified tags</td></tr><tr><td>limit</td><td>Maximum number of records to retrieve per request. Cannot exceed 250</td></tr><tr><td>since_id</td><td>Show order lines after the specified ID. Used for pagination</td></tr></tbody></table>

<details>

<summary>Example Request</summary>

```
https://os.vucustom.com/api/v1/order_lines?status=&with_tags=&without_tags=&limit&since_idmber=null
```

</details>

{% tabs %}
{% tab title="200" %}
**`200 Successful response example`**

```json
{
  "order_lines": [
    {
      "custom_attributes": {},
      "customer_requested_date": "2024-03-31",
      "estimated_arrival_date": "2024-03-31",
      "ex_factory_date": {
        "current": "2024-03-09",
        "changes": [
          {
            "reason_code": "initial",
            "reason_description": "Initial Value",
            "created_at": "2024-02-23T08:00:40.773Z",
            "estimated_arrival_date": "2024-03-31",
            "ex_factory_date": "2024-03-09"
          }
        ]
      },
      "factory_code": "factory123",
      "id": 12345,
      "line_reference": "59861396",
      "price": 70,
      "product_description": "My Widget",
      "product_id": 12345,
      "quantity": 1,
      "recipe_token": "1609c0e8",
      "status": "new_order",
      "sku": "SKU123",
      "tags": [
        "tag1",
        "tag2"
      ],
      "upc": "UPC123",
      "traveler": "{{base_url}}/api/v1/order_lines/841/traveler_file",
	   "production_files": [
					"{{base_url}}/api/v1/order_lines/841/production_file/DOD_tesst51s22s1_1abf1058_tst.png"
				],
      "fulfillments": [
        {
          "created_at": "2024-03-21T08:31:48.653Z",
          "updated_at": "2024-03-21T08:31:48.653Z",
          "quantity": 1,
          "id": 79,
          "tracking_number": "test1",
          "carrier_name": "test",
          "carrier_code": "test",
          "service_name": "test",
          "service_code": "test",
          "recipient_address_1": "test",
          "recipient_city": "test",
          "recipient_name": "test",
          "recipient_state_region": "test",
          "recipient_country": "test",
          "recipient_postal_code": "test",
          "recipient_phone": "test",
          "weight": 0,
          "width": 0,
          "height": 0,
          "length": 0
        }
      ]
    }
  ]
}
```

{% endtab %}

{% tab title="401 " %}
**`401 Unauthorized`**

`The client doesn’t have correct authentication credentials.`

```
{
"errors": "[API] Invalid API key or secret (unrecognized login or wrong password)"
}
```

{% endtab %}

{% tab title="403" %}
**`403 Forbidden`**

`The server is refusing to respond. This is typically caused by incorrect access.`
{% endtab %}

{% tab title="404" %}
**`404 Not Found`**

`The requested resource was not found but could be available again in the future.`
{% endtab %}

{% tab title="422" %}
**`422 Unprocessable Entity`**
{% endtab %}

{% tab title="5xx" %}
**`5xx Errors`**

`An internal error occurred in VU Admin.`
{% endtab %}
{% endtabs %}