Skip to main content
GET
Retrieves a customer by its ID.

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

x-companyid
string

The Company-Id (int or uuid) of the company on whose behalf the request is executed.

x-tenant-id
string<uuid>
required

The tenant ID for the target ERP instance.

Path Parameters

customerId
string<uuid>
required

Represents a unique key for identifying a customer in the JTL system.

Example:

"b45f6432-2462-4c6f-b00f-1d9d01000000"

Response

A customer.

customerId
string<uuid>

Customer id

Example:

"b45f6432-2462-4c6f-b00f-1d9d01000000"

customerGroupId
string<uuid>

Id of the customer group

Example:

"b45f6432-2462-4c6f-b00f-1d9d01000000"

customerNumber
string

Customer number

createdDate
string<date-time>

Date when the customer was created

lastChanged
string<date-time>

Date when the customer was last changed

customerAddresses
object[]

List of addresses of the customer

customerGroup
object

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