Get all users.

get

/learn.rest/v1/users

Request

Query Parameters
  • Specify how many items should be returned in a payload. Must be lower than server default limit size.
  • Specify starting point of the response.
    Default Value: 0
  • Search through users collection items. Use Mongo DB Query format. Searchable properties are - username, email, employeeId. example ?q={email:{$eq: 'user@example.com'}}
  • If set to true, the payload includes the total number of rows that satisfies the request. Use of this parameter determines if the 'last' link is displayed for a pageable collection.
Security
Back to Top

Response

Supported Media Types

200 Response

Users collection fetched.
Body ()
Root Schema : UsersResponse
Type: object
User response object.
Show Source
Example:
{
    "items":[
        {
            "id":947334,
            "username":"cwallace",
            "nickname":"cw",
            "firstName":"Christopher",
            "lastName":"Wallace",
            "street1":"500 Oracle Parkway",
            "street2":"n/a",
            "city":"Redwood Shores",
            "postalCode":"94065",
            "state":"CA",
            "country":"US",
            "phoneDaytime":"+1.650.506.7000",
            "phoneEvening":"n/a",
            "phoneMobile":"+1.800.392.2999",
            "fax":"n/a",
            "pager":"n/a",
            "pagerInteractive":"n/a",
            "email":"info@oracle.com",
            "email2":"n/a",
            "gender":"male",
            "ssn":"n/a",
            "employeeId":"n/a",
            "company":"Oracle",
            "officeName":"HQ",
            "department":"Product Development",
            "jobTitle":"Product Manager",
            "profession":"Product Management",
            "managerName":"n/a",
            "createdDate":"2011-12-01T14:50:00-05:00",
            "lastAccessedDate":"2011-12-01T14:50:00-05:00",
            "lastUpdatedDate":"2011-12-01T14:50:00-05:00",
            "lastUpdatedByUserId":947334,
            "timeZone":"Eastern Standard Time",
            "participatesInDaylight":true,
            "lastUpdatedByUser":{
                "links":[
                    {
                        "rel":"canonical",
                        "href":"{url}/learn.rest/v1/users/{userId}"
                    }
                ]
            },
            "passwordValidUntilDate":"2011-12-10T14:50:00-05:00",
            "includeInSearchFlag":true,
            "memberships":{
                "links":[
                    {
                        "rel":"canonical",
                        "href":"{url}/learn.rest/v1/users/{userId}/memberships"
                    }
                ]
            },
            "links":[
                {
                    "rel":"canonical",
                    "href":"{url}/learn.rest/v1/users/{userId}"
                }
            ]
        },
        "..."
    ],
    "totalResults":1200,
    "limit":100,
    "count":100,
    "hasMore":true,
    "links":[
        {
            "rel":"canonical",
            "href":"{url}/learn.rest/v1/users"
        },
        {
            "rel":"first",
            "href":"{url}/v1/users?limit=100&offset=0"
        },
        {
            "rel":"prev",
            "href":"{url}/learn.rest/v1/users?limit=100&offset=0"
        },
        {
            "rel":"next",
            "href":"{url}/learn.rest/v1/users?limit=100&offset=10"
        },
        {
            "rel":"last",
            "href":"{url}/learn.rest/v1/users?limit=100&offset=1200"
        }
    ]
}
Nested Schema : items
Type: array
Item object.
Show Source
Nested Schema : User
Type: object
User response object
Show Source
Example:
{
    "id":112870,
    "username":"abc",
    "nickname":"",
    "firstName":"abc",
    "lastName":"def",
    "street1":"4500 Oracle Ln",
    "street2":"Suite 400",
    "city":"Redwood Shores",
    "postalCode":"94566",
    "state":"CA",
    "country":"US",
    "phoneDaytime":"614.266.2084Ex.0000",
    "phoneEvening":"614-638-5648",
    "phoneMobile":"614.266.2084",
    "fax":"",
    "pager":"",
    "pagerInteractive":"",
    "email":"abc.def@oracle.com",
    "email2":"abc.def@oracle.com",
    "gender":"male",
    "ssn":"",
    "employeeId":"Test EEID for abc",
    "company":"Oracle",
    "officeName":"",
    "department":"",
    "jobTitle":"Job Manager",
    "profession":"",
    "managerName":"",
    "createdDate":"2011-12-01T16:36:00-05:00",
    "lastAccessedDate":"2018-12-20T12:08:00-05:00",
    "lastUpdatedDate":"2018-10-08T10:48:31-04:00",
    "lastUpdatedByUserId":112870,
    "lastUpdatedBy":{
        "links":[
            {
                "rel":"canonical",
                "href":"{url}/learn.rest/v1/users/112870"
            }
        ]
    },
    "hireDate":"2018-06-03T00:00:00",
    "lastHireDate":"2007-04-11T00:00:00",
    "lastJobChangeDate":"2012-07-02T00:00:00",
    "certificationExpirationDate":"2017-11-17T00:00:00",
    "includeInSearchFlag":true,
    "timeZone":"Eastern Standard Time",
    "participatesInDaylight":true,
    "memberships":{
        "links":[
            {
                "rel":"canonical",
                "href":"{url}/learn.rest/v1/users/112870/memberships"
            }
        ]
    },
    "links":[
        {
            "rel":"canonical",
            "href":"{url}/learn.rest/v1/users/112870"
        }
    ]
}
Nested Schema : lastUpdatedBy
Type: array
The person who last updated the user record.
Show Source
Nested Schema : UserLinkItems
Type: object
Link to user items.
Show Source
Example:
{
    "rel":"canonical",
    "href":"{url}/learn.rest/v1/users/456"
}

401 Response

Authentication refused for provided credentials or token invalid.
Headers

500 Response

Internal server error.
Back to Top