---
id: object/page/20009
type: object
title: Page 20009 "APIV1 - Customers"
summary: Page 20009 "APIV1 - Customers" in APIV1 (Microsoft.API.V1). Introduced in BC29, still in BC30.
tier: official
language: en
tags:
  - page
  - apiv1
versions:
  introduced: "29"
  last_changed: null
  deprecated: null
review:
  state: derived
  by: null
  at: null
  flags: []
generated:
  at: "2026-10-11T00:31:51.816Z"
  pipeline: 0.2.0
  prompts: {}
  input_hash: cad3b7995b0bf1d2e21ae75963d2ee8f4f698e6448d3c93db7f3f269d40651d0
evidence:
  - kind: code
    url: https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Apps/W1/APIV1/app/src/pages/APIV1Customers.Page.al
    title: src/Apps/W1/APIV1/app/src/pages/APIV1Customers.Page.al (releases/29.x)
    date: null
    commit: ea08af5ef2d6a9b5c5af4a029288abbe2c883220
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_customer_create_defaultdimensions
    title: (v1.0) Create customer defaultDimensions
    date: null
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_customer_delete_defaultdimensions
    title: (v1.0) Delete customer defaultDimensions
    date: null
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_customer_delete
    title: (v1.0) Delete customers
    date: null
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_customer_get_defaultdimensions
    title: (v1.0) Get customer defaultDimensions
    date: null
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_customer_get
    title: (v1.0) Get customers
    date: null
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_customer_update_defaultdimensions
    title: (v1.0) Update customer defaultDimensions
    date: null
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_customer_update
    title: (v1.0) Update customers
    date: null
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/resources/dynamics_customer
    title: (v1.0) customers resource type
    date: null
    commit: null
    t: null
    quote: null
links:
  learn:
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_customer_create_defaultdimensions
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_customer_delete_defaultdimensions
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_customer_delete
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_customer_get_defaultdimensions
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_customer_get
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_customer_update_defaultdimensions
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_customer_update
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/resources/dynamics_customer
  objects: []
  features: []
  topics: []
  localizations: []
  videos: []
  posts: []
  guidelines: []
object_type: page
object_id: 20009
name: APIV1 - Customers
namespace: Microsoft.API.V1
app: APIV1
extends: null
first_version: "29"
last_version: "30"
present_in:
  - "29"
  - "30"
changed_in: []
source_major: "29"
obsolete: null
countries: []
ms_search_form_ids:
  - docs/learn-devitpro/dev-itpro/api-reference/v1.0/api/dynamics_customer_create_defaultdimensions.md
  - docs/learn-devitpro/dev-itpro/api-reference/v1.0/api/dynamics_customer_delete_defaultdimensions.md
  - docs/learn-devitpro/dev-itpro/api-reference/v1.0/api/dynamics_customer_delete.md
  - docs/learn-devitpro/dev-itpro/api-reference/v1.0/api/dynamics_customer_get_defaultdimensions.md
  - docs/learn-devitpro/dev-itpro/api-reference/v1.0/api/dynamics_customer_get.md
  - docs/learn-devitpro/dev-itpro/api-reference/v1.0/api/dynamics_customer_update_defaultdimensions.md
  - docs/learn-devitpro/dev-itpro/api-reference/v1.0/api/dynamics_customer_update.md
  - docs/learn-devitpro/dev-itpro/api-reference/v1.0/resources/dynamics_customer.md
counts:
  fields: 0
  procedures: 4
  events: 0
  subscribers: 0
  controls: 22
  actions: 0
relations:
  out: 1
  referenced_by: 0
  pages: 0
  extended_by: 0
  event_subscribers: 0
  calls: 2
  called_by: 0
  implements: 0
---

# Page 20009 "APIV1 - Customers"

> Page 20009 "APIV1 - Customers" in APIV1 (Microsoft.API.V1). Introduced in BC29, still in BC30.

APIV1 · Microsoft.API.V1 · BC29-30 · [source at ea08af5e](https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Apps/W1/APIV1/app/src/pages/APIV1Customers.Page.al) · facts from BC29

## Properties

| Property | Value |
|---|---|
| Caption | 'customers', Locked = true |
| Extensible | false |
| SourceTable | Customer |
| PageType | API |

## Fields on this page

Layout controls in source order, grouped by the container they sit in. Shows: the table field a control is bound to (or its expression as written); ToolTip: the control's own, else the bound field's (marked).

| Group | Control | Shows | ToolTip |
|---|---|---|---|
| Group | id | `Rec.SystemId` | — |
|  | number | [No.](../table/18.md#fields) | Specifies the number of the customer. The field is either filled automatically from a defined number series, or you enter the number manually because you have enabled manual number entry in the number-series setup. <small>from the table field</small> |
|  | displayName | [Name](../table/18.md#fields) | Specifies the customer's name that appears on all related documents. For companies, specify the company's name here, and then add the relevant people as contacts that you link to this customer. <small>from the table field</small> |
|  | type | [Contact Type](../table/18.md#fields) | — |
|  | address | `PostalAddressJSON` | Specifies the address for the customer. |
|  | phoneNumber | [Phone No.](../table/18.md#fields) | Specifies the customer's telephone number. <small>from the table field</small> |
|  | email | [E-Mail](../table/18.md#fields) | Specifies the customer's email address. <small>from the table field</small> |
|  | website | [Home Page](../table/18.md#fields) | Specifies the customer's home page address. <small>from the table field</small> |
|  | taxLiable | [Tax Liable](../table/18.md#fields) | Specifies if the customer or vendor is liable for sales tax. <small>from the table field</small> |
|  | taxAreaId | [Tax Area ID](../table/18.md#fields) | — |
|  | taxAreaDisplayName | `TaxAreaDisplayNameGlobal` | Specifies the display name of the tax area. |
|  | taxRegistrationNumber | [VAT Registration No.](../table/18.md#fields) | Specifies the customer's VAT registration number for customers in EU countries/regions. <small>from the table field</small> |
|  | currencyId | [Currency Id](../table/18.md#fields) | — |
|  | currencyCode | `CurrencyCodeTxt` | — |
|  | paymentTermsId | [Payment Terms Id](../table/18.md#fields) | — |
|  | shipmentMethodId | [Shipment Method Id](../table/18.md#fields) | — |
|  | paymentMethodId | [Payment Method Id](../table/18.md#fields) | — |
|  | blocked | [Blocked](../table/18.md#fields) | Specifies which transactions with the customer that cannot be processed, for example, because the customer is insolvent. <small>from the table field</small> |
|  | customerFinancialDetails | part [Page 20048 "Customer Financial Details"](../page/20048.md) | — |
|  | lastModifiedDateTime | [Last Modified Date Time](../table/18.md#fields) | — |
|  | picture | part [Page 20055 "APIV1 - Pictures"](../page/20055.md) | — |
|  | defaultDimensions | part [Page 20056 "APIV1 - Default Dimensions"](../page/20056.md) | — |

## Procedures

4 local procedures, no public ones.

## Triggers

OnAfterGetRecord, OnInsertRecord, OnModifyRecord, OnNewRecord

## Relations

- source table [Table 18 "Customer"](../table/18.md)

## Calls

From the extracted call graph of BC29 (graphify-al on the snapshot checkout): calls whose target is known from a declared type or an `Object::"Name"` argument. Interface dispatch and calls through events are not counted, so the list is not complete.

- [Codeunit 5465 "Graph Mgt - General Tools"](../codeunit/5465.md) (2 calls: `OnInsertRecord → ProcessNewRecordFromAPI`, `SetCalculatedFields → TranslateNAVCurrencyCodeToCurrencyCode`)
- [Codeunit 5471 "Graph Mgt - Customer"](../codeunit/5471.md) (2 calls: `ProcessPostalAddress → UpdatePostalAddress`, `SetCalculatedFields → PostalAddressToJSON`)

## Across versions

- Present in: BC29-30
- Changed (declaration) in: none

## Documented on Microsoft Learn

- [(v1.0) Create customer defaultDimensions](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_customer_create_defaultdimensions)
- [(v1.0) Delete customer defaultDimensions](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_customer_delete_defaultdimensions)
- [(v1.0) Delete customers](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_customer_delete)
- [(v1.0) Get customer defaultDimensions](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_customer_get_defaultdimensions)
- [(v1.0) Get customers](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_customer_get)
- [(v1.0) Update customer defaultDimensions](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_customer_update_defaultdimensions)
- [(v1.0) Update customers](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_customer_update)
- [(v1.0) customers resource type](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/resources/dynamics_customer)

Source: AL metadata extracted from the code (names, ids, signatures, properties); no code bodies (D10).

## Ask your agent

Procedure bodies are not stored here (D10). The call sections above are our own, per object, from the BC29 call graph. For a procedure body or the calls of one procedure, ask bc-code-atlas (external, by Stefan Maron, MIT; default corpus w1-28), which the bc-observatory plugin connects: `bcatlas_resolve_node(object_type: "page", object_name: "APIV1 - Customers")`, then `bcatlas_get_procedure_body` or `bcatlas_get_neighbors` on the returned id.