(Quick Reference) Service: List of groups of employees

Description: This web service return the groups of employees in JSON format

URL:

https://BASE_URL/api/VERSION/employeeGroups

Method: GET

Parameters:

Pagination parameters:

NameDescriptionTypeRequiredPossible values
offsetTells where to start returning records from the entire set of resultsIntegerNo 
maxlimits the number of resources requested to returnIntegerNo 
sortOrders the results by the specified fieldStringNo 
orderOrders ascending (ASC) or descending DESCIntegerNoasc, desc

The max parameter is set to 100 by default.

Filters parameters:

NameDescriptionTypeRequiredExample values
dateCreated_gtFilters by the resource's creation date time and operator greater thanDateno2016-08-15T14:52:48Z
dateCreated_gteFilters by the resource's creation date time and operator greater than or equalDateno 
dateCreated_ltFilters by the resource's creation date time and operator less thanDateno 
dateCreated_lteFilters by the resource's creation date time and operator less than or equalDateno 
lastUpdated_gtFilters by the resource's last-modified date time and operator greater thanDateno 
lastUpdated_gteFilters by the resource's last-modified date time and operator greater than or equalDateno 
lastUpdated_ltFilters by the resource's last-modified date time and operator less thanDateno 
lastUpdated_lteFilters by the resource's last-modified date time and operator less than or equalDateno 
referenceWildcard search by the resource's referenceStringnoreference=Ref-6* , reference=*ef-6 , reference=*ef-6*
nameWildcard search by the resource's nameStringno 
Dates should be formatted as the ISO-8601 format (YYYY-MM-DDTHH:MM:SSZ)

Success Output

Success case: response.status=200

{
    "paging": {
        "total": 4,
        "max": 100,
        "offset": 0,
        "previous": null,
        "next": null
    },
    "data": [
        {
            "id": 1,
            "name": "Groupe 1",
            "reference": "REF-01",
            "organization": "Lyon",
            "description": null,
            "dateCreated": "2015-11-16T13:28:31Z",
            "lastUpdated": "2015-11-16T13:28:31Z"
        },
        {
            "id": 2,
            "name": "Groupe 2",
            "reference": "REF-02",
            "organization": "Lyon",
            "description": null,
            "dateCreated": "2015-11-16T13:28:47Z",
            "lastUpdated": "2015-11-16T13:28:47Z"
        },
        {
            "id": 3,
            "name": "Groupe 3",
            "reference": "REF-03",
            "organization": "Lyon",
            "description": null,
            "dateCreated": "2016-05-01T00:58:50Z",
            "lastUpdated": "2016-07-07T16:13:36Z"
        },
        {
            "id": 4,
            "name": "Groupe 4",
            "reference": "REF-04",
            "organization": "Lyon",
            "description": "description de groupe 4",
            "dateCreated": "2016-05-24T16:24:10Z",
            "lastUpdated": "2016-05-31T14:51:06Z"
        }
    ]
}

Failure Output

Failure case:response.status = 400
{
   "error": "invalid_param",
   "error_description": "The parameters [dateCreated_gta] you provided are not valid for this request."
}
{
    "error": "invalid_datetime_format",
    "error_description": "Invalid datetime filter (not ISO-8601 formatted): [2016-08-1Z]"
}
Failure case:response.status = 500
{
   "error": "server_error",
   "error_description": "Oops! Something went wrong..."
}