# vendor resource type
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|vendor|Gets a vendor object.
../api/dynamics_vendor_delete|none|Deletes a vendor object.
POST vendor<../api/dynamics_vendor_create>|vendor|Creates a vendor object.
PATCH vendor<../api/dynamics_vendor_update>|vendor|Updates a vendor object.
## Navigation
Navigation|Return Type|Description
dynamics_currency|currency|Gets the currency of the vendor.
dynamics_paymentterm|paymentTerm|Gets the paymentterm of the vendor.
dynamics_paymentmethod|paymentMethod|Gets the paymentmethod of the vendor.
dynamics_picture|picture|Gets the picture of the vendor.
dynamics_defaultdimension|defaultDimensions|Gets the defaultdimensions of the vendor.
dynamics_agedaccountspayable|agedAccountsPayable|Gets the agedaccountspayable of the vendor.
contactsInformation<dynamics_contactinformation>|contactsInformation|Gets the contactsinformation of the vendor.
dynamics_documentattachment|documentAttachments|Gets the documentattachments of the vendor.
## Properties
Property|Type|Description
id|GUID|The unique ID of the vendor. Non-editable.
number|string|Specifies the number of the vendor.
displayName|string|Specifies the vendor's name. This name will appear on all sales documents for the vendor.
addressLine1|string|Specifies the vendor's address. This address will appear on all sales documents for the vendor.
addressLine2|string|Specifies the vendor's address. This address will appear on all sales documents for the vendor.
city|string|Specifies the vendor's city.
state|string|Specifies the vendor's state.
country|string|Specifies the vendor's country.
postalCode|string|Specifies the vendor's postal code.
phoneNumber|string|Specifies the vendor's telephone number.
email|string|Specifies the vendor's email address.
website|string|Specifies the vendor's home page address.
taxRegistrationNumber|string|Specified the tax registration number of the vendor.
currencyId|GUID|Specifies which currency the vendor uses.
currencyCode|string|The default currency code for the vendor.
irs1099Code|string|Specifies a 1099 code for the vendor. US only.
paymentTermsId|GUID|Specifies which payment term the vendor uses.
paymentMethodId|GUID|Specifies which payment method the vendor uses.
taxLiable|boolean|Specifies if the vendor or vendor is liable for sales tax. Set to true if the vendor is tax liable.
blocked|NAV.vendorBlocked|Specifies which transactions with the customer can't be posted. It can be <Member Name=" ", "Payment" or "All".
balance|decimal|Specifies vendor's total balance.
lastModifiedDateTime|datetime|The last datetime the vendor was modified. Read-Only.
## JSON representation
Here's a JSON representation of the vendor resource.
```json
{
    "id": "GUID",
    "number": "string",
    "displayName": "string",
    "addressLine1": "string",
    "addressLine2": "string",
    "city": "string",
    "state": "string",
    "country": "string",
    "postalCode": "string",
    "phoneNumber": "string",
    "email": "string",
    "website": "string",
    "taxRegistrationNumber": "string",
    "currencyId": "GUID",
    "currencyCode": "string",
    "irs1099Code": "string",
    "paymentTermsId": "GUID",
    "paymentMethodId": "GUID",
    "taxLiable": "boolean",
    "blocked": "NAV.vendorBlocked",
    "balance": "decimal",
    "lastModifiedDateTime": "datetime"
}
```
## Related information
../api/dynamics_vendor_get
../api/dynamics_vendor_delete
POST vendor<../api/dynamics_vendor_create>
PATCH vendor<../api/dynamics_vendor_update>

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/v2.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/v2.0/resources/dynamics_vendor/
