Relesys API Docs

v1.3

https://api.relesysapp.net/api/v1.3

Welcome

Introduction Getting access

Concepts

Scopes HTTP Status Codes Request Throttling Pagination Filtering Sorting Patch Requests

Endpoints

Users

Get Users
GET /users 
https://api.relesysapp.net/api/v1.3/users
Get all users - Can be filtered by the listed properties.
Scopes: relesys.api, relesys.api:read, relesys.api.users, relesys.api.users:read
Query String
birthDate datetime Filterable Sortable optional
creationDateTime datetime Filterable Sortable optional
dataSource string Filterable Sortable optional
email string Filterable Sortable optional
employmentDate datetime Filterable Sortable optional
employmentEndDate datetime Filterable Sortable optional
externalId string Filterable Sortable optional
id string / guid Filterable optional
lastModifiedDateTime datetime Filterable Sortable optional
name string Filterable Sortable optional
primaryDepartmentId string / guid Filterable optional
secondaryEmail string Filterable Sortable optional
status string Filterable Sortable optional
title string Filterable Sortable optional
userName string Filterable Sortable optional
sort string Comma separated sort order based on sortable properties optional
offset integer Offset value for use in pagination Default: 0 optional
limit integer Total objects to fetch (max 1000) Default: 200 optional
Responses
application/json
200
Schema Example
JSON
{"count":2,"data":[{"id":"14e8264f-7581-4506-9a66-e92d5ac1ad13","url":null,"departmentUrl":null,"status":"Activated","creationDateTime":"2024-11-21T06:21:31.1621916Z","lastModifiedDateTime":"2024-11-21T06:21:31.1621916Z","externalId":"NUA","name":"New User A","userName":"UserNameA","title":"User Title A","dataSource":"RelesysAPI","email":"personalmaila@testmail.com","secondaryEmail":"businessmaila@testmail.com","phoneNumber":{"countryCode":45,"number":"12345678"},"secondaryPhoneNumber":{"countryCode":45,"number":"12345679"},"birthDate":"2002-12-30T00:00:00Z","primaryDepartmentId":"c9bfe0d3-3fdb-4a57-ba75-6c466e8d2392","additionalDepartments":[{"id":"7a4b4e44-850d-47e1-bdff-b0d472239c07","dataSource":"RelesysAPI"}],"userGroups":[{"id":"afd4476b-cba1-45cf-a01c-ae8043ea9b8e","dataSource":"RelesysAPI"},{"id":"8895de55-bba8-41e6-b390-173e26227419","dataSource":"RelesysAPI"}],"employmentDate":"2018-12-30T13:30:00Z","employmentEndDate":"2021-12-30T13:30:00Z","customFields":{"customfieldone":"Custom field 1","customfieldtwo":"Custom field 2","customfieldthree":"Custom field 3"}},{"id":"e52b5004-cc54-448e-b053-d1bed0392f3d","url":null,"departmentUrl":null,"status":"Activated","creationDateTime":"2024-11-21T06:21:31.1621916Z","lastModifiedDateTime":"2024-11-21T06:21:31.1621916Z","externalId":"NUB","name":"New User B","userName":"UserNameB","title":"User Title","dataSource":"RelesysAPI","email":"personalmailb@testmail.com","secondaryEmail":"businessmailb@testmail.com","phoneNumber":{"countryCode":45,"number":"12345678"},"secondaryPhoneNumber":{"countryCode":45,"number":"12345679"},"birthDate":"2001-12-30T00:00:00Z","primaryDepartmentId":"19352b9a-cac5-4886-9be0-7e6979ab6044","additionalDepartments":[{"id":"e1cfe24a-a50c-480c-8300-ea6ae5e32937","dataSource":"RelesysAPI"}],"userGroups":[{"id":"4821d628-d882-4bd6-be4a-1de2b79b16c1","dataSource":"RelesysAPI"},{"id":"56c4beec-8652-4243-8ba4-1ae650557670","dataSource":"RelesysAPI"}],"employmentDate":"2018-12-30T13:30:00Z","employmentEndDate":"2021-12-30T13:30:00Z","customFields":{}}]}
object
  count integer      
  ⯈ data array[object]      
   ⯈ additionalDepartments array[object]      
    dataSource string      
    id string / guid      
   birthDate datetime      
   customFields dictionary`2      
   dataSource string      
   departmentUrl string      
   email string      
   employmentDate datetime      
   employmentEndDate datetime      
   externalId string      
   id string / guid      
   name string      
   ⯈ phoneNumber object      
    countryCode integer      
    number string      
   primaryDepartmentId string / guid      
   secondaryEmail string      
   ⯈ secondaryPhoneNumber object      
    countryCode integer      
    number string      
   status string      
   title string      
   url string      
   ⯈ userGroups array[object]      
    dataSource string      
    id string / guid      
   userName string      
  nextUrl string      
  previousUrl string