---
title: "Changes to Retrieve a customer"
method: GET
path: "/quickbooks-desktop/customers/{id}"
---

# Changes to Retrieve a customer

`GET /quickbooks-desktop/customers/{id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 60 revisions.

- **2026-06-13** `f5e8ad815f89`: 5 info
- **2026-06-13** `2b44baac3231`: 1 warning
- **2026-05-02** `1de07095c4b7`: 1 warning
- **2026-05-01** `246263e100a6`: 1 breaking
- **2026-04-20** `10d4e9ebd1df`: 81 breaking, 33 info
- **2026-04-20** `8e0b7df2044d`: 73 breaking, 16 warning, 84 info
- **2026-04-20** `5f832f695675`: 81 breaking, 33 info
- **2026-03-20** `09df225c4fd3`: 1 breaking

## Changes

- **2026-06-13** `f5e8ad815f89`: 5 info
  - removed the `australia` enum value from the `salesTaxCountry/anyOf[subschema #1]/` response property for the response status `200`
  - removed the `canada` enum value from the `salesTaxCountry/anyOf[subschema #1]/` response property for the response status `200`
  - removed the `uk` enum value from the `salesTaxCountry/anyOf[subschema #1]/` response property for the response status `200`
  - removed the `united_arab_emirates` enum value from the `salesTaxCountry/anyOf[subschema #1]/` response property for the response status `200`
  - removed the `us` enum value from the `salesTaxCountry/anyOf[subschema #1]/` response property for the response status `200`
- **2026-06-13** `2b44baac3231`: 1 warning
  - added the new `united_arab_emirates` enum value to the `salesTaxCountry/anyOf[subschema #1]/` response property for the response status `200`
- **2026-05-02** `1de07095c4b7`: 1 warning
  - for the `path` request parameter `id`, the maxLength was set to `36`
- **2026-05-01** `246263e100a6`: 1 breaking
  - response property `alternateShippingAddresses` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
- **2026-04-20** `10d4e9ebd1df`: 81 breaking, 33 info
  - response property `accountNumber` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `additionalContacts/items/customContactFields/items/value` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `additionalContacts/items/jobTitle` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `additionalContacts/items/lastName` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `additionalContacts/items/middleName` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `additionalContacts/items/name` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `additionalContacts/items/salutation` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `additionalNotes/items/date` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `alternateContact` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `alternatePhone` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `alternateShippingAddresses/items/city` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `alternateShippingAddresses/items/country` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `alternateShippingAddresses/items/isDefaultShippingAddress` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `alternateShippingAddresses/items/line1` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `alternateShippingAddresses/items/line2` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `alternateShippingAddresses/items/line3` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `alternateShippingAddresses/items/line4` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `alternateShippingAddresses/items/line5` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `alternateShippingAddresses/items/name` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `alternateShippingAddresses/items/note` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `alternateShippingAddresses/items/postalCode` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `alternateShippingAddresses/items/state` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `balance` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `ccEmail` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `companyName` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `contact` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `creditLimit` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `customContactFields/items/value` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `email` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `externalId` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `fax` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `firstName` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `jobDescription` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `jobEndDate` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `jobProjectedEndDate` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `jobStartDate` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `jobStatus` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `jobTitle` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `lastName` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `middleName` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - …74 more
- **2026-04-20** `8e0b7df2044d`: 73 breaking, 16 warning, 84 info
  - the response property `accountNumber` became nullable for the status `200`
  - the response property `additionalContacts/items/customContactFields/items/value` became nullable for the status `200`
  - the response property `additionalContacts/items/jobTitle` became nullable for the status `200`
  - the response property `additionalContacts/items/lastName` became nullable for the status `200`
  - the response property `additionalContacts/items/middleName` became nullable for the status `200`
  - the response property `additionalContacts/items/name` became nullable for the status `200`
  - the response property `additionalContacts/items/salutation` became nullable for the status `200`
  - the response property `additionalNotes/items/date` became nullable for the status `200`
  - the response property `alternateContact` became nullable for the status `200`
  - the response property `alternatePhone` became nullable for the status `200`
  - the response property `alternateShippingAddresses/items/city` became nullable for the status `200`
  - the response property `alternateShippingAddresses/items/country` became nullable for the status `200`
  - the response property `alternateShippingAddresses/items/isDefaultShippingAddress` became nullable for the status `200`
  - the response property `alternateShippingAddresses/items/line1` became nullable for the status `200`
  - the response property `alternateShippingAddresses/items/line2` became nullable for the status `200`
  - the response property `alternateShippingAddresses/items/line3` became nullable for the status `200`
  - the response property `alternateShippingAddresses/items/line4` became nullable for the status `200`
  - the response property `alternateShippingAddresses/items/line5` became nullable for the status `200`
  - the response property `alternateShippingAddresses/items/name` became nullable for the status `200`
  - the response property `alternateShippingAddresses/items/note` became nullable for the status `200`
  - the response property `alternateShippingAddresses/items/postalCode` became nullable for the status `200`
  - the response property `alternateShippingAddresses/items/state` became nullable for the status `200`
  - the response property `balance` became nullable for the status `200`
  - the response property `ccEmail` became nullable for the status `200`
  - the response property `class` became nullable for the status `200`
  - the response property `companyName` became nullable for the status `200`
  - the response property `contact` became nullable for the status `200`
  - the response property `creditLimit` became nullable for the status `200`
  - the response property `currency` became nullable for the status `200`
  - the response property `customContactFields/items/value` became nullable for the status `200`
  - the response property `customerType` became nullable for the status `200`
  - the response property `email` became nullable for the status `200`
  - the response property `externalId` became nullable for the status `200`
  - the response property `fax` became nullable for the status `200`
  - the response property `firstName` became nullable for the status `200`
  - the response property `jobDescription` became nullable for the status `200`
  - the response property `jobEndDate` became nullable for the status `200`
  - the response property `jobProjectedEndDate` became nullable for the status `200`
  - the response property `jobStartDate` became nullable for the status `200`
  - the response property `jobStatus` became nullable for the status `200`
  - …133 more
- **2026-04-20** `5f832f695675`: 81 breaking, 33 info
  - response property `accountNumber` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `additionalContacts/items/customContactFields/items/value` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `additionalContacts/items/jobTitle` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `additionalContacts/items/lastName` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `additionalContacts/items/middleName` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `additionalContacts/items/name` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `additionalContacts/items/salutation` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `additionalNotes/items/date` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `alternateContact` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `alternatePhone` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `alternateShippingAddresses/items/city` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `alternateShippingAddresses/items/country` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `alternateShippingAddresses/items/isDefaultShippingAddress` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `alternateShippingAddresses/items/line1` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `alternateShippingAddresses/items/line2` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `alternateShippingAddresses/items/line3` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `alternateShippingAddresses/items/line4` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `alternateShippingAddresses/items/line5` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `alternateShippingAddresses/items/name` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `alternateShippingAddresses/items/note` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `alternateShippingAddresses/items/postalCode` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `alternateShippingAddresses/items/state` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `balance` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `ccEmail` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `companyName` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `contact` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `creditLimit` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `customContactFields/items/value` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `email` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `externalId` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `fax` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `firstName` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `jobDescription` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `jobEndDate` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `jobProjectedEndDate` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `jobStartDate` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `jobStatus` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `jobTitle` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `lastName` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `middleName` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - …74 more
- **2026-03-20** `09df225c4fd3`: 1 breaking
  - the response property `alternateShippingAddresses/items/name` became nullable for the status `200`

---

[Operation](https://skmtc.dev/conductor-is/apis/conductor-api/docs/quickbooks-desktop/customers/:id/get.md) - [API](https://skmtc.dev/conductor-is/apis/conductor-api.md) - [Page](https://skmtc.dev/conductor-is/apis/conductor-api/changes/quickbooks-desktop/customers/:id/get)
