# customers 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 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|customers|Gets a customer.
POST customers<../api/dynamics_create_customer>|customers|Creates a customer.
PATCH customers<../api/dynamics_customer_update>|customers|Updates a customer.
../api/dynamics_customer_delete|none|Deletes a customer.
## Navigation
Navigation|Return Type|Description
dynamics_picture|picture|Gets the picture of customer.
dynamics_defaultdimension|defaultDimension|Gets the defaultDimension of customer.
dynamics_customerfinancialdetails|customerFinancialDetail|Gets the customerFinancialDetails of customer.
currency<dynamics_currencies>|currency|Gets the currency of customer.
dynamics_paymentterms|paymentTerm|Gets the paymentTerm of customer.
dynamics_shipmentmethods|shipmentMethod|Gets the shipmentMethod of customer.
dynamics_paymentmethods|paymentMeth0d|Gets the paymentMethod of customer.
## Properties
Property|Type|Description
id|GUID|The unique ID of the item. Non-editable.
number|string|The customer number.
displayName|string|Specifies the customer's name. This name will appear on all sales documents for the customer.
type|string|Specifies the type of customer, can be "Company" or "Person".
address|NAV.PostalAddress<dynamics_complextypes>|Specifies the customer's address. This address will appear on all sales documents for the customer.
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.
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, maximum size 20|Specified the tax registration number of the customer.
currencyId|GUID|Specifies which currency the customer uses.
currencyCode|numeric|The default currency code for the customer.
paymentTermsId|GUID|Specifies which payment term the customer uses.
paymentMethodId|GUID|Specifies which payment method the customer uses.
shipmentMethodId|GUID|Specifies which shipment method the customer uses.
blocked|string|Specifies that transactions with the customer cannot be posted. Set to All, if the customer is blocked, set to blank if not blocked.
lastModifiedDateTime|datetime|The last datetime the customer was modified. Read-Only.
## Relationships
A Currency(currencyCode) must exist in the Currencies table.
A Payment Term(paymentTerms) must exist in the Payment Terms table.
A Shipment Method(shipmentMethod) must exist in the Shipment Method table.
A Payment Method(paymentMethod) must exist in the Payment Method table.
A Tax Area(taxArea) must exist in the Tax Area table.
Financial details of the customer (customerFinancialDetails) can be retrieved.
## JSON representation
Here is a JSON representation of the resource.
```json
{
    "id": "GUID",
    "number": "string",
    "displayName": "string",
    "type": "string",
    "address": NAV.PostalAddress,
    "phoneNumber": "string",
    "email": "string",
    "website": "string",
    "taxLiable": "boolean",
    "taxAreaId": "GUID",
    "taxAreaDisplayName": "string",
    "taxRegistrationNumber": "string",
    "currencyCode": "string",
    "paymentTermsId": "GUID",
    "shipmentMethod": NAV.ShipmentMethod,
    "paymentMethod":  NAV.PaymentMethod,
    "blocked": "string",
    "balance": "decimal",
    "overdueAmount": "numeric",
    "totalSalesExcludingTax": "numeric",
    "lastModifiedDateTime": "datetime"
}
```
## Related information
../api/dynamics_customer_get
Post Customers<../api/dynamics_create_customer>
Patch Customers<../api/dynamics_customer_update>
../api/dynamics_customer_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_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/v1.0/resources/dynamics_customer/
