---
title: "List suppliers"
description: "Retrieve the suppliers and vendors Qashio can attribute spend to."
source: https://developers.qashio.com/v2/reference/get-public-v1-erp-suppliers/
---

# List suppliers

`GET /public/v1/erp/suppliers`

Requires a Bearer access token.

**Purpose.** Retrieve the suppliers and vendors Qashio can attribute spend to.

**Description.** Returns a paginated list of suppliers synced from your accounting system, newest
first. Transactions reference these records so that card spend can be matched to the correct vendor
when a bill or expense is created in your ledger.

**Input (query).** `page`, `page_size`, `remote_id`, `remote_name`, `status`
(`draft` / `active` / `inactive`), `is_deleted` (`true` / `false`),
`created_at_from` / `created_at_to`, `updated_at_from` / `updated_at_to`.

**Output.** Array of suppliers, plus `pagination`.

| Field | Type | Description |
| --- | --- | --- |
| `id` | string | Qashio identifier (UUID) |
| `qashio_external_id` | string | Cross-reference used on transactions |
| `remote_id` | string | Identifier in your accounting system |
| `remote_name` | string | Supplier name |
| `status` | string | `draft`, `active` or `inactive` |
| `is_deleted` | boolean | Marked deleted upstream |
| `created_at` / `updated_at` | string | ISO 8601 timestamps |

**Errors.** `400`, `401`, `403`.

### Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `page` | integer | no |  |
| `page_size` | integer | no |  |
| `remote_id` | string | no |  |
| `remote_name` | string | no |  |
| `status` | string | no | One of `draft`, `active`, `inactive`. |
| `is_deleted` | string | no | One of `true`, `false`. |
| `created_at_from` | string | no |  |
| `created_at_to` | string | no |  |
| `updated_at_from` | string | no |  |
| `updated_at_to` | string | no |  |

### Example request

```bash
curl -X GET 'https://api.qashio.com/public/v1/erp/suppliers?page=1&page_size=20' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <access_token>'
```

### Example response (200)

```json
{
  "status_code": 200,
  "success": true,
  "data": [
    {
      "id": "11742018-a8fe-4a06-a924-3b69bf302d9a",
      "remote_name": "QSupplier 1",
      "qashio_external_id": "ECSr09kixq6xzuabk",
      "remote_id": "295",
      "status": "active",
      "is_deleted": false,
      "updated_at": "2026-09-01T14:27:23.972Z",
      "created_at": "2026-09-01T14:27:23.972Z"
    }
  ],
  "meta": {
    "request_id": "3adb2d16090c7b3bdbde3b326a814b30",
    "timestamp": "2026-09-09T10:07:52.143Z"
  },
  "pagination": {
    "page": 1,
    "page_size": 20,
    "total_pages": 1,
    "total_records": 7,
    "has_next": false,
    "has_previous": false
  }
}
```

### Errors

- `401` Unauthorized - missing or invalid Bearer token