curl --request GET \
--url https://api.scholarlysoftware.com/api/v1/users \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.scholarlysoftware.com/api/v1/users"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.scholarlysoftware.com/api/v1/users', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "user",
"attributes": {
"created_at": "<string>",
"updated_at": "<string>",
"display_name": "<string>",
"primary_employee_id": "<string>",
"emails": [
"primary@example.com",
"secondary@example.com"
],
"deactivated": true,
"custom_fields": {},
"employee_ids": {}
},
"relationships": {
"profile": {
"links": {
"related": "<string>"
},
"meta": {},
"data": {
"type": "profile",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
},
"employments": {
"links": {
"related": "<string>"
},
"meta": {},
"data": [
{
"type": "employment",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
]
},
"current_employment": {
"links": {
"related": "<string>"
},
"meta": {},
"data": {
"type": "employment",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
},
"admin_assistant_roles": {
"links": {
"related": "<string>"
},
"meta": {}
},
"addresses": {
"links": {
"related": "<string>"
},
"meta": {}
},
"phone_numbers": {
"links": {
"related": "<string>"
},
"meta": {}
}
}
}
],
"meta": {
"page": {
"size": 123
},
"total": 123
},
"links": {
"self": "<string>",
"first": "<string>",
"next": "<string>",
"prev": "<string>",
"last": "<string>"
}
}{
"errors": [
{
"status": "<string>",
"title": "<string>",
"detail": "<string>"
}
]
}List users
Return a list of users.
Filter by an employee id configuration with filter[employee_ids][<configuration name>]=<id>,
or by a comma-separated list with filter[employee_ids.in][<configuration name>]=<id>,<id>.
The neq, cont, and nin operators take the same form.
curl --request GET \
--url https://api.scholarlysoftware.com/api/v1/users \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.scholarlysoftware.com/api/v1/users"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.scholarlysoftware.com/api/v1/users', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "user",
"attributes": {
"created_at": "<string>",
"updated_at": "<string>",
"display_name": "<string>",
"primary_employee_id": "<string>",
"emails": [
"primary@example.com",
"secondary@example.com"
],
"deactivated": true,
"custom_fields": {},
"employee_ids": {}
},
"relationships": {
"profile": {
"links": {
"related": "<string>"
},
"meta": {},
"data": {
"type": "profile",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
},
"employments": {
"links": {
"related": "<string>"
},
"meta": {},
"data": [
{
"type": "employment",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
]
},
"current_employment": {
"links": {
"related": "<string>"
},
"meta": {},
"data": {
"type": "employment",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
},
"admin_assistant_roles": {
"links": {
"related": "<string>"
},
"meta": {}
},
"addresses": {
"links": {
"related": "<string>"
},
"meta": {}
},
"phone_numbers": {
"links": {
"related": "<string>"
},
"meta": {}
}
}
}
],
"meta": {
"page": {
"size": 123
},
"total": 123
},
"links": {
"self": "<string>",
"first": "<string>",
"next": "<string>",
"prev": "<string>",
"last": "<string>"
}
}{
"errors": [
{
"status": "<string>",
"title": "<string>",
"detail": "<string>"
}
]
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Bearer token
Query Parameters
Comma-separated list of relationships to include. Allowed: profile, employments, current_employment, admin_assistant_roles, addresses, phone_numbers
Sort order. Prefix with - for descending. Allowed: created_at, updated_at, display_name
Filter results. Available filters: created_at, created_at.neq, created_at.lt, created_at.lte, created_at.gt, created_at.gte, updated_at, updated_at.neq, updated_at.lt, updated_at.lte, updated_at.gt, updated_at.gte, email, employee_id, display_name, display_name.neq, display_name.cont (case-insensitive substring match), display_name.in (list of values, comma-separated), display_name.nin (list of values, comma-separated), profile, profile.exists (boolean), employments, current_employment, current_employment.exists (boolean), admin_assistant_roles, addresses, phone_numbers. Filter by a custom field with filter[custom_fields][<key>]=<value>. The neq, cont, in, nin, lt, lte, gt, and gte operators take the form filter[custom_fields.<operator>][<key>]=<value>, where the field's type decides which apply.
Number of items per page (max 100)
Cursor for next page
Cursor for previous page