# List suppliers (your VAs) and the stores they can see

> Eto API reference for `GET /api/v1/suppliers`. Base URL `https://eto.tools/api/v1/`. Authenticate with the `X-Eto-API-Key` header.

Part of the [Eto API reference](https://eto.tools/dev/docs/). The full reference in one file is at [llms-full.txt](https://eto.tools/dev/docs/llms-full.txt); the machine-readable schema is at [openapi.json](https://eto.tools/dev/docs/openapi.json).

## GET /api/v1/suppliers

List suppliers (your VAs) and the stores they can see

- Operation ID: `suppliers_list`
- Slug: `suppliers-list`
- Category: Orders
- Authentication: API key only. Reads or writes data Eto holds for your own account.
- HTML: https://eto.tools/dev/docs/#ep-suppliers-list
- Markdown: https://eto.tools/dev/docs/orders/suppliers-list.md

Suppliers are your active VAs (virtual assistants). Each one handles the order items of the products and stores assigned to them, packs them and adds tracking. This lists every active supplier with `id`, `name` (your private label) and the `stores` whose orders they can see (View Orders). A supplier can only be assigned to listings and stores in that list. Zero Etsy calls. To assign, use PUT /api/v1/supplier-assignments.

### Parameters

None. Send the request with only the API key header.

### Request

```bash
curl -X GET "https://eto.tools/api/v1/suppliers" \
  -H "X-Eto-API-Key: eto_your_key"
```

```python
import requests

url = "https://eto.tools/api/v1/suppliers"
headers = {"X-Eto-API-Key": "eto_your_key"}

response = requests.get(url, headers=headers, timeout=120)
response.raise_for_status()
print(response.json())
```

```javascript
const url = "https://eto.tools/api/v1/suppliers";

const response = await fetch(url, {
  method: "GET",
  headers: {
    "X-Eto-API-Key": "eto_your_key",
  },
});
if (!response.ok) throw new Error(`Eto API ${response.status}`);
const data = await response.json();
```

### Response

```json
{
  "suppliers": [
    {"id": 41, "name": "Anna (mugs)", "display_name": "Anna",
     "stores": [{"shop_id": "12345678", "shop_name": "OakAndClay"}]}
  ]
}
```

### Errors

Failures answer with the shared error body described in the Errors section: `{"error": {"code", "status", "message", "hint", "docs"}}`. Branch on `code`, not on the message.
