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

# List vendors

`GET /vendors`

## Request

- Base URL: `https://ledgerhq.pro/api/v1`
- URL: `https://ledgerhq.pro/api/v1/vendors`
- Auth: one of:
  - HTTP bearer and API key in header `x-organization-id`
  - HTTP bearer and API key in header `x-organization-id`

Supplier/both contacts for the company, name order. ytdPaidCents is calendar-year-to-date made payments in integer cents through today, including bank, card and check payments and posted bank-feed or card-feed withdrawals coded to the vendor without a payment record, excluding deleted payments. TIN is never returned in full: only tinLast4 and presence-based hasTin are exposed (the detail route validates readability with a fail-closed trial decryption instead).

## Query parameters

- `limit` integer
- `offset` integer
- `includeInactive` boolean
- `search` string

## Response `200`

Vendors

## Other responses

- `default`: Error response

## Changes

- **2026-10-20** `01c3e57d281f`: 1 info
  - added the new optional `query` request parameter `search`

[Operation history](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/changes/vendors/get.md)

---

[API](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api.md) · [All operations](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/revisions/9a8269f0a586?raw)