---
title: "Retrieve a payments Vendor"
method: GET
path: "/payments/vendor/{id}"
tags: ["payments"]
---

# Retrieve a payments Vendor

`GET /payments/vendor/{id}`

Retrieve a single accounting vendor by ID.

## Path parameters

- `id` string, required

## Headers

- `Authorization` string, required
- `X-Api-Key` string, required
- `X-API-Version` string

## Response `200`

Successfully retrieved

- PaymentsGetPaymentsVendorIdResponse200
  - `id` string — The unique identifier of the vendor.
  - `ottimate_company_id` string — The Ottimate company ID associated with this vendor.
  - `name` string — The vendor's business name.
  - `erp_vendor_id` string — The vendor's unique identifier in your ERP system.
  - `customer_account_number` string — Your account number with this vendor.
  - `is_ach_enrolled` boolean — Whether the vendor is enrolled in ACH electronic payments.
  - `estimated_monthly_volume` integer — Estimated monthly payment volume to this vendor in dollars.
  - `email` string — The vendor's primary email address.
  - `contact_name` string — The vendor's primary contact name.
  - `phone_number` string — The vendor's primary phone number.
  - `invite_electronic_payments` boolean — Whether the vendor has been invited to enroll in electronic payments.
  - `address_line_1` string — The first line of the vendor's mailing address.
  - `address_line_2` string — The second line of the vendor's mailing address.
  - `city` string — The city of the vendor's mailing address.
  - `state` string — The two-letter state code of the vendor's mailing address.
  - `zipcode` string — The ZIP code of the vendor's mailing address.
  - `country` string — The two-letter ISO country code of the vendor's mailing address.
  - `care_of` string — The care-of name for the vendor's mailing address.
  - `admin_email` string — The email address of the vendor's admin contact.
  - `admin_phone` string — The phone number of the vendor's admin contact.
  - `admin_name` string — The name of the vendor's admin contact.
  - `metadata` PaymentsVendorIdGetResponsesContentApplicationJsonSchemaMetadata — Additional key-value metadata associated with the vendor.

## Other responses

- `403` — Forbidden - Access denied or insufficient permissions
- `404` — Not found - Resource does not exist

## Changes

- **2026-08-19** `c0b5cf6c7a72` — 1 info
  - added the non-success response with the status `403`
- **2026-08-17** `c231509a03cf` — 1 breaking, 2 info
  - the `message` response's property type/format changed from `string`/`` to ``/`` for status `404`
  - the response property `code` became required for the status `404`
  - the response property `message` became required for the status `404`
- **2026-08-13** `1f089f3e34d9` — 3 breaking
  - the response property `code` became optional for the status `404`
  - the response property `message` became optional for the status `404`
  - the `message` response's property type/format changed from ``/`` to `string`/`` for status `404`

[Change history](https://skmtc.dev/ottimate/apis/api-reference/changes/payments/vendor/:id/get.md)

---

[API](https://skmtc.dev/ottimate/apis/api-reference.md) · [All operations](https://skmtc.dev/ottimate/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ottimate/api-reference/revisions/ba91ff4c6969/schema)