> For the complete documentation index, see [llms.txt](https://docs.fieldmotion.com/fieldmotion-api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fieldmotion.com/fieldmotion-api-docs/stock/_listbysupplier.md).

# \_listBySupplier

List Stock items associated with a given Supplier, ordered by stock item name. Uses the supplier\_id field in the stock table.

### Parameters

#### supplier\_id

Integer. The ID of the supplier.

### Example

```
FM_api('Stock_listBySupplier',
		[
			'supplier_id'=>'2'
		]
	);
```

### Result

#### On Success

The id, name and code of each stock item associated with the chosen supplier.

Example:

```
[{"id":"1","name":"Item1","code":"0001"},{"id":"2","name":"Item2","code":"2000"}]
```

#### On Failure

If no supplier ID provided:

```
{"error":"no Supplier ID provided"}
```