> 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/fulfillments/retrieve-a-list-of-fulfillments.md).

# Retrieve a list of fulfillments

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

{% code fullWidth="false" %}

```url
https://os.vucustom.com/api/:api_version/fulfillments?tracking_numbers=&limit
```

{% endcode %}

URL Parameters

<table><thead><tr><th width="187">Field Name</th><th>Description</th></tr></thead><tbody><tr><td>tracking_numbers</td><td>Comma-separated list of tracking numbers for retrieving multiple fulfillments</td></tr><tr><td>limit</td><td>Maximum number of records to retrieve. Cannot exceed 250</td></tr></tbody></table>

<details>

<summary>Example Request</summary>

```
https://os.vucustom.com/api/:api_version/fulfillments?tracking_numbers=&limit=null
```

</details>

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

```json
{
	"fulfillments": [{
		"id": 78,
		"tracking_number": "12345",
		"carrier_name": "Fedex",
		"carrier_code": "FED",
		"service_name": "Next day air",
		"service_code": "NDA",
		"weight": "1.5",
		"recipient": {
			"recipient_address_1": "test str 1",
			"recipient_city": "Test",
			"recipient_name": "Test Test",
			"recipient_state_region": "DE",
			"recipient_country": "US",
			"recipient_postal_code": "123",
			"recipient_phone": "123"
		},
		"dimensions": {
			"height": "3.5",
			"width": "3.0",
			"length": "3.0"
		},
		"order_lines": [
			{
				"id": 110,
				"order_line_id": 391,
				"quantity": 1
			}
		]
	}
    ]
}
```

{% 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 %}