# Suppliers

Company supplier directory — lookup endpoint for resolving `supplierId` on PO create/update payloads.

**Response envelope:** `{ status, data[], pagination, error }`.

Source: company supplier records configured in AutoLeap (same suppliers selectable on purchase orders).


## List suppliers

 - [GET /suppliers](https://developers.myautoleap.com/openapi/suppliers/listsuppliers.md): Returns a paginated list of suppliers for the specified company.

Use the returned id as supplierId when creating or updating purchase orders.

### Validation errors (HTTP 400)

| Condition | Result |
|---|---|
| Missing companyId | HTTP 400 |
| Unknown companyId for partner | HTTP 400 — Invalid company external id. |
| Unknown locationId | HTTP 400 |

Partner must have Suppliers permission enabled — otherwise HTTP 403.