Skip to main content
GET
/
customerGroups
Query Customer Groups
curl --request GET \
  --url https://api.jtl-cloud.com/erp/customerGroups \
  --header 'Authorization: Bearer <token>' \
  --header 'x-tenant-id: <x-tenant-id>'
[
  {
    "Id": 123,
    "Name": "<string>",
    "IsDefault": true,
    "Discount": 123,
    "IsNetPrice": true
  }
]

Authorizations

Authorization
string
header
required

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

Headers

x-tenant-id
string<uuid>
required

The tenant ID for the target ERP instance.

x-runas
string

The User-Id (int or uuid) on whose behalf the request is executed. Requires scope 'Application.RunAs'.

x-companyid
string

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

Response

Returns all customer groups.

Id
integer<int32>
required

Unique internal ID of the customer group.

Name
string
required

The name of the customer group.

IsDefault
boolean
required

Indicates if the customer group is the default group. Only one group can be selected as the default group.

Discount
number<decimal>
required

The discounted percentage for the customer group.

IsNetPrice
boolean
required

Indicates if the customer group sees the net price in the online shop.