---
title: "Vendors · Practice Manager API · COUNT Partner API"
description: "Vendors are the suppliers, merchants, contractors, and contacts you pay through bills and expense transactions. A vendor holds contact details, an optional…"
canonical: "https://developers.getcount.com/practice-manager/reference/vendors"
source: "https://developers.getcount.com/practice-manager/reference/vendors"
---
Practice Manager API

# Vendors

Vendors are the suppliers, merchants, contractors, and contacts you pay through bills and expense transactions. A vendor holds contact details, an optional address, 1099 tax settings, and status.

Last updated 2026-11-18

## Overview

The Vendors API lets your integration list, create, update, and delete vendors in a workspace. Vendors represent anyone you pay — suppliers, merchants, contractors, and other contacts.

Partner responses expose each vendor UUID as `id` and remove internal numeric identifiers and foreign keys such as `teamId`.

## Key concepts

### Identification

Vendors are referenced by UUID returned as `id`. Pass that value in the path to update or delete.

### Required fields

Only `name` is required to create a vendor. Address and contacts can be supplied inline.

### Duplicate handling

Creating a vendor with a name that matches an active vendor returns 400. Creating with a name that matches an inactive vendor reactivates and updates that record.

### 1099 vendors

Set `is1099` and related tax fields for contractor reporting. The API validates 1099 field combinations on create and update.

## The vendor object

Fields returned on a vendor. Address and contacts are embedded when present.

#### Attributes

`id` uuid

Vendor identifier (UUID). Use in path parameters for update and delete.

`name` string

Vendor display name. Required on create.

`email` string

Primary email address.

`mainPhone` string

Primary phone number.

`website` string

Website URL.

`accountNumber` string

Your internal vendor account number.

`status` enum

Vendor status. Defaults to active.

One of: `active`, `inactive`

`type` enum

Vendor classification. Defaults to MERCHANT.

One of: `MERCHANT`, `SUPPLIER`, `CONTRACTOR`, `CONTACT`, `OWNER`

`legalName` string

Legal entity name for tax reporting.

`businessName` string

Doing-business-as name when different from legal name.

`taxNumber` string

Tax identification number.

`taxType` enum

Tax id type.

One of: `none`, `ssn`, `ein`, `itin`, `atin`

`is1099` boolean

Whether the vendor receives 1099 reporting.

`address` object

Mailing address, or null.

`street` string

Street address.

`city` string

City or locality.

`state` string

State, province, or region.

`zipCode` string

Postal or ZIP code.

`country` string

Country name or ISO code.

`contacts` array

Contact people for this vendor.

`id` uuid

Contact identifier (UUID).

`firstName` string

Contact's first name.

`lastName` string

Contact's last name.

`email` string

Contact's email address.

`phone` string

Contact's phone number.

`isPrimary` boolean

Marks the primary contact.

`createdAt` datetime

ISO 8601 creation timestamp.

`updatedAt` datetime

ISO 8601 last update timestamp.

Example

```json
{
  "id": "d4e5f6a7-b8c9-0123-defa-234567890123",
  "name": "Office Depot",
  "email": "ap@officedepot.com",
  "mainPhone": "+18001234567",
  "website": "https://officedepot.com",
  "accountNumber": "V-1001",
  "status": "active",
  "type": "SUPPLIER",
  "legalName": "Office Depot Inc.",
  "businessName": null,
  "taxNumber": null,
  "taxType": "none",
  "is1099": false,
  "address": {
    "street": "500 Supply Chain Blvd",
    "city": "Boca Raton",
    "state": "FL",
    "zipCode": "33431",
    "country": "USA"
  },
  "contacts": [
    {
      "id": "a5da3577-bf85-4e3a-aa73-df85ca69bc67",
      "firstName": "Accounts",
      "lastName": "Payable",
      "email": "ap@officedepot.com",
      "phone": "+18001234567",
      "isPrimary": true
    }
  ],
  "createdAt": "2026-01-15T10:30:00.000Z",
  "updatedAt": "2026-01-28T14:22:30.000Z"
}
```

Search covers name, account number, and contact email

The `search` query parameter on list matches vendor name, account number, and contact email addresses (case-insensitive, partial).

Contractor-linked vendors

Vendors linked to a payroll contractor person record have restricted update fields. Attempts to change protected keys return 400.

## Endpoints

[GET List vendors `/firm-partners/workspace/vendors` Returns a paginated list of vendors in the workspace.](https://developers.getcount.com/practice-manager/reference/vendors/list-vendors) [POST Create vendor `/firm-partners/workspace/vendors` Creates a new vendor in the workspace.](https://developers.getcount.com/practice-manager/reference/vendors/create-vendor) [PATCH Update vendor `/firm-partners/workspace/vendors/{uuid}` Updates an existing vendor. Only the fields you send are changed.](https://developers.getcount.com/practice-manager/reference/vendors/update-vendor) [DELETE Delete vendor `/firm-partners/workspace/vendors/{uuid}` Deletes a vendor by UUID.](https://developers.getcount.com/practice-manager/reference/vendors/delete-vendor)
