get https://{host}/api_gateway/core/v1/group
This API allows you to retrieve details of all the reward groups available in the org.
Note
For detailed information about our APIs and for hands-on testing, refer documentation in API overview and step-by-step guide on making your first API call in Make your first API call .
Prerequisites
- Authentication: Basic or OAuth authentication
- Default access group
Resource information
| URI | /api_gateway/core/v1/group |
| HTTP method | GET |
| Pagination | Yes |
| Rate limit | NA |
| Batch support | NA |
API endpoint example
https://eucrm.cc.capillarytech.com/api_gateway/core/v1/group
Request query parameters
| Parameters | Data type | Description |
|---|---|---|
| orderBy | Enum | Sort response based on order. Supported values: ASC and DESC |
| active | Boolean | Indicates if the group is active. |
| name | String | Name of the group. Enter the group name to retrieve group details. |
| size | Integer | The number of items or records returned in a single API response. |
| page | Integer | The amount of the data that you want to retrieve. Default value: 10. |
https://crm-nightly-new.cc.capillarytech.com/api_gateway/rewards/core/v1/group?page=0&size=10&active=true&name=VIP&orderBy=ASC
Response parameters
| Parameter Name | Data Type | Description |
|---|---|---|
| id | Integer | The unique identifier of the group. |
| orgId | Integer | The organization identifier the group belongs to. |
| name | String | The name of the group. |
| rank | Integer | The numerical rank associated with the group. |
| isActive | Boolean | Indicates if the group is active. |
| createdBy | Integer | The identifier of the user who created the group. |
| createdOn | Long | The timestamp when the group was created. |
| lastUpdatedBy | Integer | The identifier of the user who last updated the group. |
| lastUpdatedOn | Long | The timestamp when the group was last updated. |
| last | Boolean | Indicates if the current page is the last page. |
| totalElements | Integer | The total number of elements across all pages. |
| totalPages | Integer | The total number of pages available. |
| numberOfElements | Integer | The number of elements in the current page. |
| first | Boolean | Indicates if the current page is the first page. |
| size | Integer | The number of elements per page. |
| number | Integer | The current page number (zero-based). |
| code | Integer | The code associated with the operation status. |
| message | String | A message describing the operation outcome. |
| success | Boolean | Indicates if the operation was successful. |
{
"status": {
"success": true,
"code": 12013,
"message": "Get all groups fetched successfully"
},
"groupRoList": [
{
"id": 7,
"orgId": 51226,
"name": "VIP4",
"rank": 2,
"isActive": true,
"createdBy": 50699846,
"createdOn": 1707029484000,
"lastUpdatedBy": 50699846,
"lastUpdatedOn": 1707029484000
},
{
"id": 8,
"orgId": 51226,
"name": "VIP5",
"rank": 2,
"isActive": true,
"createdBy": 50699846,
"createdOn": 1707029488000,
"lastUpdatedBy": 50699846,
"lastUpdatedOn": 1707029488000
},
{
"id": 9,
"orgId": 51226,
"name": "VIP6",
"rank": 2,
"isActive": true,
"createdBy": 50699846,
"createdOn": 1707029491000,
"lastUpdatedBy": 50699846,
"lastUpdatedOn": 1707029491000
},
{
"id": 10,
"orgId": 51226,
"name": "VIP7",
"rank": 2,
"isActive": true,
"createdBy": 50699846,
"createdOn": 1707029494000,
"lastUpdatedBy": 50699846,
"lastUpdatedOn": 1707029494000
},
{
"id": 11,
"orgId": 51226,
"name": "VIP8",
"rank": 2,
"isActive": true,
"createdBy": 50699846,
"createdOn": 1707029497000,
"lastUpdatedBy": 50699846,
"lastUpdatedOn": 1707029497000
},
{
"id": 12,
"orgId": 51226,
"name": "VIP9",
"rank": 2,
"isActive": true,
"createdBy": 50699846,
"createdOn": 1707029500000,
"lastUpdatedBy": 50699846,
"lastUpdatedOn": 1707029500000
},
{
"id": 13,
"orgId": 51226,
"name": "VIP10",
"rank": 2,
"isActive": true,
"createdBy": 50699846,
"createdOn": 1707029503000,
"lastUpdatedBy": 50699846,
"lastUpdatedOn": 1707029503000
},
{
"id": 14,
"orgId": 51226,
"name": "VIP11",
"rank": 2,
"isActive": true,
"createdBy": 50699846,
"createdOn": 1707029506000,
"lastUpdatedBy": 50699846,
"lastUpdatedOn": 1707029506000
},
{
"id": 3,
"orgId": 51226,
"name": "VIP14",
"rank": 78,
"isActive": true,
"createdBy": 50699846,
"createdOn": 1707025497000,
"lastUpdatedBy": 50699846,
"lastUpdatedOn": 1707034678000
},
{
"id": 4,
"orgId": 51226,
"name": "VIP17",
"rank": 78,
"isActive": true,
"createdBy": 50699846,
"createdOn": 1707025500000,
"lastUpdatedBy": 50699846,
"lastUpdatedOn": 1707034713000
}
],
"pagingDto": {
"last": false,
"totalElements": 28,
"totalPages": 3,
"numberOfElements": 10,
"first": true,
"size": 10,
"number": 0
}
}