> ## Documentation Index
> Fetch the complete documentation index at: https://developer.jtl-software.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GetCustomerById

> Retrieves a customer by its ID.



**query** `GetCustomerById(customerId: ID!): Customer!`

## Arguments

**`customerId`**: `ID!` (required)

## Returns

`Customer!`

**`customerId`**: `ID!`

Customer id

---

**`customerGroupId`**: `ID!`

Id of the customer group

---

**`customerNumber`**: `String`

Customer number

---

**`createdDate`**: `DateTime`

Date when the customer was created

---

**`lastChanged`**: `DateTime`

Date when the customer was last changed

---

**`customerAddresses`**: `[CustomerAddress!]!`

List of addresses of the customer

---

**`customerGroup`**: `CustomerGroup!`

The customer group of the customer

---

**`languageIso`**: `String`

The language iso code of the customer

---

**`commercialRegisterNumber`**: `String`

The commercial register number of the customer

---

**`taxIdentificationNumber`**: `String`

The tax identification number of the customer

---

**`homepage`**: `String`

The homepage URL of the customer

---

**`isLocked`**: `Boolean!`

The locked status of the customer

## Examples

```graphql Query
query GetCustomerById($customerId: ID!) {
  GetCustomerById(customerId: $customerId) {
    customerId
    customerGroupId
    customerNumber
    createdDate
    lastChanged
    customerAddresses {
      customerAddressId
      customerId
      isDefault
      addressType
      companyName
      additionalCompanyLine
    }
  }
}
```

```json Variables
{
  "customerId": "id"
}
```

```json Response
{
  "data": {
    "GetCustomerById": {
      "customerId": "id",
      "customerGroupId": "id",
      "customerNumber": "string",
      "createdDate": "value",
      "lastChanged": "value",
      "customerAddresses": [
        {
          "customerAddressId": "id",
          "customerId": "id",
          "isDefault": true,
          "addressType": "SHIPMENT_ADDRESS",
          "companyName": "string",
          "additionalCompanyLine": "string"
        }
      ]
    }
  }
}
```
