{"title":"customer resource type","url":"https://jonas-paprotka.de/docs/dev-itpro/api-reference/v2.0/resources/dynamics_customer/","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_customer, 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_customer","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 customer object in Dynamics 365 Business Central.","date":"2026-08-21","meta":{"topic":"reference"},"outline":[{"level":1,"title":"customer resource type","slug":"customer-resource-type","at":0,"chars":4603},{"level":2,"title":"Methods","slug":"methods","at":226,"chars":397},{"level":2,"title":"Navigation","slug":"navigation","at":623,"chars":906},{"level":2,"title":"Properties","slug":"properties","at":1529,"chars":2019},{"level":2,"title":"JSON representation","slug":"json-representation","at":3548,"chars":877},{"level":2,"title":"Related information","slug":"related-information","at":4425,"chars":178}],"text":"# customer resource type\nRepresents a customer 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_customer_get|customer|Gets a customer object.\n../api/dynamics_customer_delete|none|Deletes a customer object.\nPOST customer<../api/dynamics_customer_create>|customer|Creates a customer object.\nPATCH customer<../api/dynamics_customer_update>|customer|Updates a customer object.\n../api/dynamics_customer_get|customer|Gets a customer object.\n## Navigation\nNavigation|Return Type|Description\ndynamics_currency|currency|Gets the currency of the customer.\ndynamics_paymentterm|paymentTerm|Gets the paymentterm of the customer.\ndynamics_shipmentmethod|shipmentMethod|Gets the shipmentmethod of the customer.\ndynamics_paymentmethod|paymentMethod|Gets the paymentmethod of the customer.\ndynamics_customerfinancialdetail|customerFinancialDetail|Gets the customerfinancialdetail of the customer.\ndynamics_picture|picture|Gets the picture of the customer.\ndynamics_defaultdimension|defaultDimensions|Gets the defaultdimensions of the customer.\ndynamics_agedaccountsreceivable|agedAccountsReceivable|Gets the agedaccountsreceivable of the customer.\ncontactsInformation<dynamics_contactinformation>|contactsInformation|Gets the contactsinformation of the customer.\ndynamics_documentattachment|documentAttachments|Gets the documentattachments of the customer.\n## Properties\n|Property|Type|Description|\n|id|GUID|The unique ID of the customer. Non-editable.|\n|number|string|Specifies the number of the customer.|\n|displayName|string|Specifies the customer's name. This name will appear on all sales documents for the customer.|\n|type|NAV.contactType|Specifies the type of customer, can be \"Company\" or \"Person\".|\n|addressLine1|string|Specifies the customer's address. This address will appear on all sales documents for the customer.|\n|addressLine2|string|Specifies the customer's address. This address will appear on all sales documents for the customer.|\n|city|string|Specifies the customer's city.|\n|state|string|Specifies the customer's state.|\n|country|string|Specifies the customer's country.|\n|postalCode|string|Specifies the customer's postal code.|\n|phoneNumber|string|Specifies the customer's telephone number.|\n|email|string|Specifies the customer's email address.|\n|website|string|Specifies the customer's home page address.|\n|salespersonCode|string||\n|balanceDue|decimal|Specifies total balance due.|\n|creditLimit|decimal||\n|taxLiable|boolean|Specifies if the customer or vendor is liable for sales tax. Set to true if the customer is tax liable.|\n|taxAreaId|GUID|Specifies which tax area the customer belongs to.|\n|taxAreaDisplayName|string|Specified the display name of the tax area the customer belongs to.|\n|taxRegistrationNumber|string|Specified the tax registration number of the customer.|\n|currencyId|GUID|Specifies which currency the customer uses.|\n|currencyCode|string|The default currency code for the customer.|\n|paymentTermsId|GUID|Specifies which payment term the customer uses.|\n|shipmentMethodId|GUID|Specifies which shipment method the customer uses.|\n|paymentMethodId|GUID|Specifies which payment method the customer uses.|\n|blocked|NAV.customerBlocked|Specifies which transactions with the customer can't be posted. It can be \" \", \"Ship\", \"Invoice\" or \"All\".|\n|lastModifiedDateTime|datetime|The last datetime the customer was modified. Read-Only.|\n## JSON representation\nHere's a JSON representation of the customer resource.\n```json\n{\n    \"id\": \"GUID\",\n    \"number\": \"string\",\n    \"displayName\": \"string\",\n    \"type\": \"NAV.contactType\",\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    \"salespersonCode\": \"string\",\n    \"balanceDue\": \"decimal\",\n    \"creditLimit\": \"decimal\",\n    \"taxLiable\": \"boolean\",\n    \"taxAreaId\": \"GUID\",\n    \"taxAreaDisplayName\": \"string\",\n    \"taxRegistrationNumber\": \"string\",\n    \"currencyId\": \"GUID\",\n    \"currencyCode\": \"string\",\n    \"paymentTermsId\": \"GUID\",\n    \"shipmentMethodId\": \"GUID\",\n    \"paymentMethodId\": \"GUID\",\n    \"blocked\": \"NAV.customerBlocked\",\n    \"lastModifiedDateTime\": \"datetime\"\n}\n```\n## Related information\n../api/dynamics_customer_get\n../api/dynamics_customer_delete\nPOST customer<../api/dynamics_customer_create>\nPATCH customer<../api/dynamics_customer_update>"}