{"title":"vendor resource type","url":"https://jonas-paprotka.de/docs/dev-itpro/api-reference/v2.0/resources/dynamics_vendor/","by":"JOP-AL","license":"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.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/api-reference/v2.0/resources/dynamics_vendor","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"A vendor object in Dynamics 365 Business Central.","date":"2026-08-21","meta":{"topic":"reference"},"outline":[{"level":1,"title":"vendor resource type","slug":"vendor-resource-type","at":0,"chars":3731},{"level":2,"title":"Methods","slug":"methods","at":222,"chars":309},{"level":2,"title":"Navigation","slug":"navigation","at":531,"chars":694},{"level":2,"title":"Properties","slug":"properties","at":1225,"chars":1628},{"level":2,"title":"JSON representation","slug":"json-representation","at":2853,"chars":712},{"level":2,"title":"Related information","slug":"related-information","at":3565,"chars":166}],"text":"# vendor resource type\nRepresents a vendor in Business Central.\n> NOTE\n> For information about enabling APIs for Business Central see Enabling the APIs for Dynamics 365 Business Central<../enabling-apis-for-dynamics-nav>.\n## Methods\nMethod|Return Type|Description\n../api/dynamics_vendor_get|vendor|Gets a vendor object.\n../api/dynamics_vendor_delete|none|Deletes a vendor object.\nPOST vendor<../api/dynamics_vendor_create>|vendor|Creates a vendor object.\nPATCH vendor<../api/dynamics_vendor_update>|vendor|Updates a vendor object.\n## Navigation\nNavigation|Return Type|Description\ndynamics_currency|currency|Gets the currency of the vendor.\ndynamics_paymentterm|paymentTerm|Gets the paymentterm of the vendor.\ndynamics_paymentmethod|paymentMethod|Gets the paymentmethod of the vendor.\ndynamics_picture|picture|Gets the picture of the vendor.\ndynamics_defaultdimension|defaultDimensions|Gets the defaultdimensions of the vendor.\ndynamics_agedaccountspayable|agedAccountsPayable|Gets the agedaccountspayable of the vendor.\ncontactsInformation<dynamics_contactinformation>|contactsInformation|Gets the contactsinformation of the vendor.\ndynamics_documentattachment|documentAttachments|Gets the documentattachments of the vendor.\n## Properties\nProperty|Type|Description\nid|GUID|The unique ID of the vendor. Non-editable.\nnumber|string|Specifies the number of the vendor.\ndisplayName|string|Specifies the vendor's name. This name will appear on all sales documents for the vendor.\naddressLine1|string|Specifies the vendor's address. This address will appear on all sales documents for the vendor.\naddressLine2|string|Specifies the vendor's address. This address will appear on all sales documents for the vendor.\ncity|string|Specifies the vendor's city.\nstate|string|Specifies the vendor's state.\ncountry|string|Specifies the vendor's country.\npostalCode|string|Specifies the vendor's postal code.\nphoneNumber|string|Specifies the vendor's telephone number.\nemail|string|Specifies the vendor's email address.\nwebsite|string|Specifies the vendor's home page address.\ntaxRegistrationNumber|string|Specified the tax registration number of the vendor.\ncurrencyId|GUID|Specifies which currency the vendor uses.\ncurrencyCode|string|The default currency code for the vendor.\nirs1099Code|string|Specifies a 1099 code for the vendor. US only.\npaymentTermsId|GUID|Specifies which payment term the vendor uses.\npaymentMethodId|GUID|Specifies which payment method the vendor uses.\ntaxLiable|boolean|Specifies if the vendor or vendor is liable for sales tax. Set to true if the vendor is tax liable.\nblocked|NAV.vendorBlocked|Specifies which transactions with the customer can't be posted. It can be <Member Name=\" \", \"Payment\" or \"All\".\nbalance|decimal|Specifies vendor's total balance.\nlastModifiedDateTime|datetime|The last datetime the vendor was modified. Read-Only.\n## JSON representation\nHere's a JSON representation of the vendor resource.\n```json\n{\n    \"id\": \"GUID\",\n    \"number\": \"string\",\n    \"displayName\": \"string\",\n    \"addressLine1\": \"string\",\n    \"addressLine2\": \"string\",\n    \"city\": \"string\",\n    \"state\": \"string\",\n    \"country\": \"string\",\n    \"postalCode\": \"string\",\n    \"phoneNumber\": \"string\",\n    \"email\": \"string\",\n    \"website\": \"string\",\n    \"taxRegistrationNumber\": \"string\",\n    \"currencyId\": \"GUID\",\n    \"currencyCode\": \"string\",\n    \"irs1099Code\": \"string\",\n    \"paymentTermsId\": \"GUID\",\n    \"paymentMethodId\": \"GUID\",\n    \"taxLiable\": \"boolean\",\n    \"blocked\": \"NAV.vendorBlocked\",\n    \"balance\": \"decimal\",\n    \"lastModifiedDateTime\": \"datetime\"\n}\n```\n## Related information\n../api/dynamics_vendor_get\n../api/dynamics_vendor_delete\nPOST vendor<../api/dynamics_vendor_create>\nPATCH vendor<../api/dynamics_vendor_update>"}