Get customer group

Get information about a specific customer group in an Ecwid store referring to its ID.

Request and response example

Request:

curl --location 'https://app.ecwid.com/api/v3/1003/customer_groups/9367001' \
--header 'Authorization: Bearer secret_ab***cd'

Response:

{
    "id": 9367001,
    "name": "VIP"
}

Access scopes

Requires the following access scope: read_customers

Path params

ParamTypeDescription
storeIdnumberEcwid store ID.
groupIdnumberCustomer group ID.

Query params

All query params are optional.

ParamTypeDescription
customerGroupIdnumberID of customer group. Supports multiple values, for example: 13456, 35678, 57890
keywordstringSearch term for the customer group name.
limitnumberMaximum number of returned items. Default value: 100. Maximum allowed value: 1000.
offsetnumberSet offset from the beginning of the returned items list by a margin of 100 (for paging).
responseFieldsstringLimit JSON response by specific fields. If specified, all missing fields will be removed from the response body.
Example: ?responseFields=name

Example of using responseFields param:

curl --location 'https://app.ecwid.com/api/v3/1003/customer_groups/9367001?responseFields=name' \
--header 'Authorization: Bearer secret_ab***cd'
{
    "name": "VIP"
}

Headers

The Authorization header with a secret access token is required.

HeaderFormatDescription
AuthorizationBearer secret_ab***cdAccess token of the application.

Response

A JSON object with the following fields:

FieldTypeDescription
totalnumberThe total number of created customer groups (may differ from the number of returned items)
countnumberThe number of returned items (excluding the default customer group)
offsetnumberOffset from the beginning of the returned items list (for paging)
limitnumberMaximum number of returned items. Maximum allowed value: 1000. Default value: 100
itemsArray itemsDetailed list of found customer groups

items

FieldTypeDescription
idnumberUnique internal customer group ID.
namestringCustomer group name.
Language
Click Try It! to start a request and see the response here!