---
title: "Lists all vendors"
method: GET
path: "/vendors"
tags: ["Vendors"]
---

# Lists all vendors

`GET /vendors`

Returns vendors with pagination and optional status or currency filters.
Vendor ids feed bill creation, vendor credits, and payment workflows.

## Query parameters

- `limit` integer
- `cursor` string — If defined, a cursor to retrieve the next page.
- `updated.gt` string, date-time

## Response `200`

OK

- object
  - `vendors` VendorResponse[], required
    - `name` string, required
    - `account_code` string — The account code found in the Chart of Accounts
    - `address` Address
      - `line1` string, required
      - `line2` string
      - `city` string, required
      - `state` string, required — State or province code (e.g. 'TN', 'CA' for US; 'ON' for Canada). Required when address is provided.
      - `zip_code` string, required
      - `country` string, required — Two-letter country code (ISO 3166-1 alpha-2).
    - `email` string, email
    - `payment_terms` integer
    - `external_references` ExternalReference[]
      - `type` string, required
      - `id` string, required
      - `url` string, uri
    - `ten_ninety_nine_eligible` boolean
    - `tax_id` string
    - `fields` object[]
      - `field_id` string, uuid, required
      - `field_value_id` string, uuid, required
    - `id` string, uuid, required
    - `updated_at` string, date-time, required
  - `pagination` Pagination, required
    - `next_cursor` string — If defined, a cursor to retrieve the next page.

## Other responses

- `default` — Error

---

[API](https://skmtc.net/rillet/apis/rillet-accounting-api.md) · [All operations](https://skmtc.net/rillet/apis/rillet-accounting-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rillet/rillet-accounting-api/versions/a2ab794dd5f2/schema)