# vendors resource type (v1.0)
> NEW VERSION This is v1.0 of the Business Central API. For the newest version, see Business Central API (V2.0)<../../v2.0>.
Represents a vendor in Business Central.
> NOTE
> For information about enabling APIs for Business Central see Enabling the APIs for Dynamics 365 Business Central<../enabling-apis-for-dynamics-nav>.
## Methods
Method|Return Type|Description
../api/dynamics_vendor_get|vendors|Gets a vendor object.
POST vendors<../api/dynamics_create_vendor>|vendors|Creates a vendor object.
PATCH vendors<../api/dynamics_vendor_update>|vendors|Updates a vendor object.
../api/dynamics_vendor_delete|none|Deletes a vendor object.
## Navigation
Go to|Type|Description
dynamics_picture|picture|Gets the picture of vendor.
dynamics_defaultdimension|defaultDimension|Gets the defaultDimension of vendor.
currency<dynamics_currencies>|currency|Gets the currency of vendor.
dynamics_paymentterms|paymentTerm|Gets the paymentTerm of vendor.
dynamics_paymentmethods|paymentMethod|Gets the paymentMethod of vendor.
## Properties
Property|Type|Description
id|GUID|The unique ID of the vendor. Non-editable.
number|string|The vendor number.
displayName|string|The vendor's display name.
address|NAV.PostalAddress<dynamics_complextypes>|The vendor's address.
phoneNumber|string|The vendor's telephone number.
email|string|The vendor's email address.
website|string|The vendor's website address.
taxRegistrationNumber|string|The vendor's tax registration number.
currencyId|GUID|The default currency code ID for the vendor.
currencyCode|string|The default currency code for the vendor.
irs1099Code|string|Specifies a 1099 code for the vendor. US only.
paymentTermsId|GUID|The default payment terms ID for the vendor.
paymentMethodId|GUID|The default payment method ID for the vendor.
taxLiable|boolean|Specifies if the vendor is liable for tax.
blocked|string|Specifies which transactions with the vendor that cannot be posted. Accepted values are blank, Payment or All
balance|decimal|The vendor's balance. Read-Only.
lastModifiedDateTime|datetime|The last datetime the vendor was modified. Read-Only.
## Relationships
Picture, defaultDimension, currency, paymentTerm, paymentMethod
## JSON representation
Here is a JSON representation of the vendor.
```json
{
  "id": "GUID",
  "number": "string",
  "displayName": "string",
  "address": "NAV.PostalAddress",
  "phoneNumber": "string",
  "email": "string",
  "website": "string",
  "taxRegistrationNumber": "string",
  "currencyId": "GUID",
  "currencyCode": "string",
  "irs1099Code": "string",
  "paymentTermsId": "GUID",
  "paymentMethodId": "GUID",
  "paymentMethod": "NAV.PaymentMethod",
  "taxLiable": "boolean",
  "blocked": "string",
  "balance": "decimal",
  "lastModifiedDateTime": "datetime"
}
```
## Related information
../api/dynamics_vendor_get
../api/dynamics_create_vendor
../api/dynamics_vendor_update
../api/dynamics_vendor_delete

Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/api-reference/v1.0/resources/dynamics_vendor, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact. https://jonas-paprotka.de/docs/dev-itpro/api-reference/v1.0/resources/dynamics_vendor/
