--- title: "Vendors 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/reference/vendors" source: "https://developers.getcount.com/reference/vendors" --- API Reference # 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-06-21 ## 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. ## Recent changes 2026-09-07 Accounting Playbooks and Ledger Semantics published as documentation The workflows and behaviour rules the MCP server serves to agents through COUNT_playbooks and COUNT_knowledge are now readable documentation. Accounting Playbooks (/guides/playbooks) covers nine ordered workflows across 54 steps — invoicing, credit memos, recurring templates, vendor bill payment, chart-of-accounts setup, migration imports, budget planning and round-trip, and month-end review — each naming the exact tool per step. Ledger Semantics & Lifecycles (/guides/ledger-semantics) documents 33 confirmed behaviours across twelve resources: the state each operation is valid in, the fields accepted and then ignored, and the calls that cannot be undone, with every irreversible behaviour collected in one table at the top of the page. Both pages carry the COUNT_playbooks and COUNT_knowledge ids they were ported from so the agent-facing and human-facing copies stay in step. Playbooks, lifecycle sections, and individual behaviour rules are indexed into site search. 2026-06-21 Complete Partner API reference Documented all remaining API reference groups: Chart of Accounts, Vendors, Products & Services, Recurring Invoice Templates, Credit Memos, Bills, Journal Entries, Tags, People, Projects, Tasks, Time Entries, Expense Receipts, Reports, and Workspace Stats. Added missing invoice endpoints (audit log, attachments, credit application, remove transaction) and group overviews for Invoices and Transactions. ## Endpoints [GET List vendors `/partners/vendors` Returns a paginated list of vendors in the workspace.](https://developers.getcount.com/reference/vendors/list-vendors) [POST Create vendor `/partners/vendors` Creates a new vendor in the workspace.](https://developers.getcount.com/reference/vendors/create-vendor) [PATCH Update vendor `/partners/vendors/{uuid}` Updates an existing vendor. Only the fields you send are changed.](https://developers.getcount.com/reference/vendors/update-vendor) [DELETE Delete vendor `/partners/vendors/{uuid}` Deletes a vendor by UUID.](https://developers.getcount.com/reference/vendors/delete-vendor)