---
title: "Retrieves a vendor"
method: GET
path: "/vendors/{vendor_id}"
tags: ["Vendors"]
---

# Retrieves a vendor

`GET /vendors/{vendor_id}`

Fetches the full vendor profile including identifiers you must echo back on PUT updates.
Use before editing to avoid wiping optional fields, and when validating tax or payment metadata during bill entry.

## Path parameters

- `vendor_id` string, required

## Response `200`

OK

- VendorResponse
  - `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

## 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)