Skip to main content

List Users

Retrieve a list of users based on the provided email filter

GET
/api/scim/v2/Users

Headers

KeyValue
Acceptapplication/json
AuthorizationBearer <API Token>

Query parameters

ParameterTypeDescription
filter (optional)StringQuery for filtering documents. eg. userEmail eq "user@example.com"
startIndex (optional)IntegerIndex of the first user to be returned
count (optional)IntegerNumber of users to be returned

Example cURL

curl --location 'http://localhost:8080/api/scim/v2/Users?filter=userEmail eq "user@example.com"&startIndex=0&count=10' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX'

Responses

Status CodeDescriptionResponse
200Successapplication/json
400Invalid Requestempty
401Unauthorizedempty
500Internal Server Errorempty

Sample response

200 : Success

{
"schemas": [
"urn:ietf:params:scim:api:messages:2.0:ListResponse"
],
"Resources": [
{
"groups": [
{
"display": "Default",
"value": 3966
}
],
"emails": [
{
"value": "user@example.com",
"primary": true
}
],
"meta": {
"location": "http://localhost:8080/api/scim/v2/Users/563504",
"created": "2023-08-04T08:38:02.3732123Z"
},
"schemas": [
"urn:ietf:params:scim:schemas:core:2.0:User"
],
"name": {
"givenName": null,
"familyName": null
},
"photos": [],
"nickName": null,
"userName": "user@example.com",
"displayName": "Rishabh Jain",
"externalId": null,
"timezone": null,
"title": null,
"active": true,
"profileUrl": "",
"id": "563504"
}
],
"startIndex": 1,
"totalResults": 50,
"itemsPerPage": 1
}