# customer resource type
Represents a customer 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_customer_get|customer|Gets a customer object.
../api/dynamics_customer_delete|none|Deletes a customer object.
POST customer<../api/dynamics_customer_create>|customer|Creates a customer object.
PATCH customer<../api/dynamics_customer_update>|customer|Updates a customer object.
../api/dynamics_customer_get|customer|Gets a customer object.
## Navigation
Navigation|Return Type|Description
dynamics_currency|currency|Gets the currency of the customer.
dynamics_paymentterm|paymentTerm|Gets the paymentterm of the customer.
dynamics_shipmentmethod|shipmentMethod|Gets the shipmentmethod of the customer.
dynamics_paymentmethod|paymentMethod|Gets the paymentmethod of the customer.
dynamics_customerfinancialdetail|customerFinancialDetail|Gets the customerfinancialdetail of the customer.
dynamics_picture|picture|Gets the picture of the customer.
dynamics_defaultdimension|defaultDimensions|Gets the defaultdimensions of the customer.
dynamics_agedaccountsreceivable|agedAccountsReceivable|Gets the agedaccountsreceivable of the customer.
contactsInformation<dynamics_contactinformation>|contactsInformation|Gets the contactsinformation of the customer.
dynamics_documentattachment|documentAttachments|Gets the documentattachments of the customer.
## Properties
|Property|Type|Description|
|id|GUID|The unique ID of the customer. Non-editable.|
|number|string|Specifies the number of the customer.|
|displayName|string|Specifies the customer's name. This name will appear on all sales documents for the customer.|
|type|NAV.contactType|Specifies the type of customer, can be "Company" or "Person".|
|addressLine1|string|Specifies the customer's address. This address will appear on all sales documents for the customer.|
|addressLine2|string|Specifies the customer's address. This address will appear on all sales documents for the customer.|
|city|string|Specifies the customer's city.|
|state|string|Specifies the customer's state.|
|country|string|Specifies the customer's country.|
|postalCode|string|Specifies the customer's postal code.|
|phoneNumber|string|Specifies the customer's telephone number.|
|email|string|Specifies the customer's email address.|
|website|string|Specifies the customer's home page address.|
|salespersonCode|string||
|balanceDue|decimal|Specifies total balance due.|
|creditLimit|decimal||
|taxLiable|boolean|Specifies if the customer or vendor is liable for sales tax. Set to true if the customer is tax liable.|
|taxAreaId|GUID|Specifies which tax area the customer belongs to.|
|taxAreaDisplayName|string|Specified the display name of the tax area the customer belongs to.|
|taxRegistrationNumber|string|Specified the tax registration number of the customer.|
|currencyId|GUID|Specifies which currency the customer uses.|
|currencyCode|string|The default currency code for the customer.|
|paymentTermsId|GUID|Specifies which payment term the customer uses.|
|shipmentMethodId|GUID|Specifies which shipment method the customer uses.|
|paymentMethodId|GUID|Specifies which payment method the customer uses.|
|blocked|NAV.customerBlocked|Specifies which transactions with the customer can't be posted. It can be " ", "Ship", "Invoice" or "All".|
|lastModifiedDateTime|datetime|The last datetime the customer was modified. Read-Only.|
## JSON representation
Here's a JSON representation of the customer resource.
```json
{
    "id": "GUID",
    "number": "string",
    "displayName": "string",
    "type": "NAV.contactType",
    "addressLine1": "string",
    "addressLine2": "string",
    "city": "string",
    "state": "string",
    "country": "string",
    "postalCode": "string",
    "phoneNumber": "string",
    "email": "string",
    "website": "string",
    "salespersonCode": "string",
    "balanceDue": "decimal",
    "creditLimit": "decimal",
    "taxLiable": "boolean",
    "taxAreaId": "GUID",
    "taxAreaDisplayName": "string",
    "taxRegistrationNumber": "string",
    "currencyId": "GUID",
    "currencyCode": "string",
    "paymentTermsId": "GUID",
    "shipmentMethodId": "GUID",
    "paymentMethodId": "GUID",
    "blocked": "NAV.customerBlocked",
    "lastModifiedDateTime": "datetime"
}
```
## Related information
../api/dynamics_customer_get
../api/dynamics_customer_delete
POST customer<../api/dynamics_customer_create>
PATCH customer<../api/dynamics_customer_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_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. https://jonas-paprotka.de/docs/dev-itpro/api-reference/v2.0/resources/dynamics_customer/
