Fortinet black logo

online help

Get User List

Copy Link
Copy Doc ID d2c8e2ba-6afb-11ea-9384-00505692583a:571554

Get User List

Description

Get details of all users of the cloud services under the same company and business unit.

URL

api/v1/profile/user/list

Method: Get

Request Header

Key

Value

Type

Description

companyId <Company ID> Integer Company ID
Authorization Bearer <Authorization Token> String Authorization credential generated by FortiCASB

buId

<Business Unit ID>

Long

The targeted business unit ID on FortiCASB. Business unit ID can be obtained through View or Remove Business User. Alternatively, it can also be obtained from the REST API Get Resource Map

service

<Cloud Service>

String

Name of the cloud service such as Salesforce, Office365, etc.

Content-Type application/json String

Sample Request

Request URL

GET https://www.forticasb.com/api/v1/profile/user/list

Request Header

Authorization: Bearer <Authorization_Token>

Content-Type: application/json

service: Office365

buid: 6384

companyid: 6

Response Variable

Name

Required

Type

Description

companyId Required Long Company ID
userId Required String The user identity
origUserId Required String The original user identity
deleted Required boolean The current user information deleted or not
createdDate Required long Timestamp, user created date
service Required Application Cloud service name
isActive Required boolean User active status
buId optional Long Business unit ID
createdById optional String The ID which created this user
lastModifiedDate optional long Timestamp, the last time that this user has been modified
lastModifiedById optional String The last user id that modified this user information
lastLoginDate optional long Timestamp, the last time that this user login into FortiCASB
systemModstamp optional long Timestamp of the system
email optional String The email of the registered user
userName optional String The user name of the registered user
name optional String This user's name
firstName optional String This user's first name
lastName optional String This user's last name
userType optional UserTypeEnum User type
profileId optional String This user's profile ID
userRoleId optional String This user's role ID

Sample Response

[

{

"companyId": "6",

"buId": 6384,

"userId": "b1664a40-136c-41be-9681-9f22eed51232",

"origUserId": "b1664a40-136c-41be-9681-9f22eed51232",

"deleted": false,

"createdDate": 1585545017056,

"lastModifiedDate": 0,

"systemModstamp": 0,

"email": "forticasb@casbqa1.onmicrosoft.com",

"userName": "forticasb@casbqa1.onmicrosoft.com",

"name": "CASB Fortinet",

"firstName": "CASB",

"lastName": "Fortinet",

"service": "OFFICE365",

"lastLoginDate": 0,

"isActive": false

},

{

"companyId": "6",

"buId": 6384,

"userId": "5aecfbb1-18e2-41c1-a17e-e0e686ee1e79",

"origUserId": "5aecfbb1-18e2-41c1-a17e-e0e686ee1e79",

"deleted": false,

"createdDate": 1585545002021,

"lastModifiedDate": 0,

"systemModstamp": 0,

"email": "qa@casbqa1.onmicrosoft.com",

"userName": "qa@casbqa1.onmicrosoft.com",

"name": "qa casb",

"firstName": "qa",

"lastName": "casb",

"service": "OFFICE365",

"lastLoginDate": 0,

"isActive": false

},

{

"companyId": "6",

"buId": 6384,

"userId": "c918ce45-9378-4de6-94e0-d23c753c616f",

"origUserId": "c918ce45-9378-4de6-94e0-d23c753c616f",

"deleted": false,

"createdDate": 1585545068508,

"lastModifiedDate": 0,

"systemModstamp": 0,

"email": "auto_test@casbqa1.onmicrosoft.com",

"userName": "auto_test@casbqa1.onmicrosoft.com",

"name": "auto_test",

"service": "OFFICE365",

"lastLoginDate": 0,

"isActive": false

},

{

"companyId": "6",

"buId": 6384,

"userId": "b4544b94-adf5-4fe9-a759-5373dcbea7b0",

"origUserId": "b4544b94-adf5-4fe9-a759-5373dcbea7b0",

"deleted": false,

"createdDate": 1585545043287,

"lastModifiedDate": 0,

"systemModstamp": 0,

"email": "groupmember1@casbqa1.onmicrosoft.com",

"userName": "groupmember1@casbqa1.onmicrosoft.com",

"name": "member group",

"firstName": "member",

"lastName": "group",

"service": "OFFICE365",

"lastLoginDate": 0,

"isActive": false

},

{

"companyId": "6",

"buId": 6384,

"userId": "5e754109-346b-4925-bd48-57143921a134",

"origUserId": "5e754109-346b-4925-bd48-57143921a134",

"deleted": false,

"createdDate": 1585545107580,

"lastModifiedDate": 0,

"systemModstamp": 0,

"email": "mh20110503@gmail.com",

"userName": "mh20110503_gmail.com#EXT#@casbqa1.onmicrosoft.com",

"name": "Guest User",

"firstName": "User",

"lastName": "Guest",

"service": "OFFICE365",

"lastLoginDate": 0,

"isActive": false

},

{

"companyId": "6",

"buId": 6384,

"userId": "6f72bc90-8a58-49f0-a27a-b2453e5cdb86",

"origUserId": "6f72bc90-8a58-49f0-a27a-b2453e5cdb86",

"deleted": false,

"createdDate": 1585545055496,

"lastModifiedDate": 0,

"systemModstamp": 0,

"email": "testreport@casbqa1.onmicrosoft.com",

"userName": "testreport@casbqa1.onmicrosoft.com",

"name": "Report Test",

"firstName": "Report",

"lastName": "Test",

"service": "OFFICE365",

"lastLoginDate": 0,

"isActive": false

},

{

"companyId": "6",

"buId": 6384,

"userId": "b9dd2da0-7a59-41dd-a4ed-af11d51ea935",

"origUserId": "b9dd2da0-7a59-41dd-a4ed-af11d51ea935",

"deleted": false,

"createdDate": 1585545081671,

"lastModifiedDate": 0,

"systemModstamp": 0,

"email": "test20200305@casbqa1.onmicrosoft.com",

"userName": "test20200305@casbqa1.onmicrosoft.com",

"name": "test 20200305",

"firstName": "test",

"lastName": "20200305",

"service": "OFFICE365",

"lastLoginDate": 0,

"isActive": false

},

{

"companyId": "6",

"buId": 6384,

"userId": "2349ce5f-6bbc-42f9-957a-93dfda3e6e2e",

"origUserId": "2349ce5f-6bbc-42f9-957a-93dfda3e6e2e",

"deleted": false,

"createdDate": 1585545094771,

"lastModifiedDate": 0,

"systemModstamp": 0,

"email": "testuser@casbqa1.onmicrosoft.com",

"userName": "testuser@casbqa1.onmicrosoft.com",

"name": "test user0306",

"firstName": "test",

"lastName": "user0306",

"service": "OFFICE365",

"lastLoginDate": 0,

"isActive": false

},

{

"companyId": "6",

"buId": 6384,

"userId": "3dbc2c02-bfa5-4323-85ab-c37e4726e8ee",

"origUserId": "3dbc2c02-bfa5-4323-85ab-c37e4726e8ee",

"deleted": false,

"createdDate": 1585545030381,

"lastModifiedDate": 0,

"systemModstamp": 0,

"email": "internaluser@casbqa1.onmicrosoft.com",

"userName": "internaluser@casbqa1.onmicrosoft.com",

"name": "User Internal",

"firstName": "User",

"lastName": "Internal",

"service": "OFFICE365",

"lastLoginDate": 0,

"isActive": false

}

]

Get User List

Description

Get details of all users of the cloud services under the same company and business unit.

URL

api/v1/profile/user/list

Method: Get

Request Header

Key

Value

Type

Description

companyId <Company ID> Integer Company ID
Authorization Bearer <Authorization Token> String Authorization credential generated by FortiCASB

buId

<Business Unit ID>

Long

The targeted business unit ID on FortiCASB. Business unit ID can be obtained through View or Remove Business User. Alternatively, it can also be obtained from the REST API Get Resource Map

service

<Cloud Service>

String

Name of the cloud service such as Salesforce, Office365, etc.

Content-Type application/json String

Sample Request

Request URL

GET https://www.forticasb.com/api/v1/profile/user/list

Request Header

Authorization: Bearer <Authorization_Token>

Content-Type: application/json

service: Office365

buid: 6384

companyid: 6

Response Variable

Name

Required

Type

Description

companyId Required Long Company ID
userId Required String The user identity
origUserId Required String The original user identity
deleted Required boolean The current user information deleted or not
createdDate Required long Timestamp, user created date
service Required Application Cloud service name
isActive Required boolean User active status
buId optional Long Business unit ID
createdById optional String The ID which created this user
lastModifiedDate optional long Timestamp, the last time that this user has been modified
lastModifiedById optional String The last user id that modified this user information
lastLoginDate optional long Timestamp, the last time that this user login into FortiCASB
systemModstamp optional long Timestamp of the system
email optional String The email of the registered user
userName optional String The user name of the registered user
name optional String This user's name
firstName optional String This user's first name
lastName optional String This user's last name
userType optional UserTypeEnum User type
profileId optional String This user's profile ID
userRoleId optional String This user's role ID

Sample Response

[

{

"companyId": "6",

"buId": 6384,

"userId": "b1664a40-136c-41be-9681-9f22eed51232",

"origUserId": "b1664a40-136c-41be-9681-9f22eed51232",

"deleted": false,

"createdDate": 1585545017056,

"lastModifiedDate": 0,

"systemModstamp": 0,

"email": "forticasb@casbqa1.onmicrosoft.com",

"userName": "forticasb@casbqa1.onmicrosoft.com",

"name": "CASB Fortinet",

"firstName": "CASB",

"lastName": "Fortinet",

"service": "OFFICE365",

"lastLoginDate": 0,

"isActive": false

},

{

"companyId": "6",

"buId": 6384,

"userId": "5aecfbb1-18e2-41c1-a17e-e0e686ee1e79",

"origUserId": "5aecfbb1-18e2-41c1-a17e-e0e686ee1e79",

"deleted": false,

"createdDate": 1585545002021,

"lastModifiedDate": 0,

"systemModstamp": 0,

"email": "qa@casbqa1.onmicrosoft.com",

"userName": "qa@casbqa1.onmicrosoft.com",

"name": "qa casb",

"firstName": "qa",

"lastName": "casb",

"service": "OFFICE365",

"lastLoginDate": 0,

"isActive": false

},

{

"companyId": "6",

"buId": 6384,

"userId": "c918ce45-9378-4de6-94e0-d23c753c616f",

"origUserId": "c918ce45-9378-4de6-94e0-d23c753c616f",

"deleted": false,

"createdDate": 1585545068508,

"lastModifiedDate": 0,

"systemModstamp": 0,

"email": "auto_test@casbqa1.onmicrosoft.com",

"userName": "auto_test@casbqa1.onmicrosoft.com",

"name": "auto_test",

"service": "OFFICE365",

"lastLoginDate": 0,

"isActive": false

},

{

"companyId": "6",

"buId": 6384,

"userId": "b4544b94-adf5-4fe9-a759-5373dcbea7b0",

"origUserId": "b4544b94-adf5-4fe9-a759-5373dcbea7b0",

"deleted": false,

"createdDate": 1585545043287,

"lastModifiedDate": 0,

"systemModstamp": 0,

"email": "groupmember1@casbqa1.onmicrosoft.com",

"userName": "groupmember1@casbqa1.onmicrosoft.com",

"name": "member group",

"firstName": "member",

"lastName": "group",

"service": "OFFICE365",

"lastLoginDate": 0,

"isActive": false

},

{

"companyId": "6",

"buId": 6384,

"userId": "5e754109-346b-4925-bd48-57143921a134",

"origUserId": "5e754109-346b-4925-bd48-57143921a134",

"deleted": false,

"createdDate": 1585545107580,

"lastModifiedDate": 0,

"systemModstamp": 0,

"email": "mh20110503@gmail.com",

"userName": "mh20110503_gmail.com#EXT#@casbqa1.onmicrosoft.com",

"name": "Guest User",

"firstName": "User",

"lastName": "Guest",

"service": "OFFICE365",

"lastLoginDate": 0,

"isActive": false

},

{

"companyId": "6",

"buId": 6384,

"userId": "6f72bc90-8a58-49f0-a27a-b2453e5cdb86",

"origUserId": "6f72bc90-8a58-49f0-a27a-b2453e5cdb86",

"deleted": false,

"createdDate": 1585545055496,

"lastModifiedDate": 0,

"systemModstamp": 0,

"email": "testreport@casbqa1.onmicrosoft.com",

"userName": "testreport@casbqa1.onmicrosoft.com",

"name": "Report Test",

"firstName": "Report",

"lastName": "Test",

"service": "OFFICE365",

"lastLoginDate": 0,

"isActive": false

},

{

"companyId": "6",

"buId": 6384,

"userId": "b9dd2da0-7a59-41dd-a4ed-af11d51ea935",

"origUserId": "b9dd2da0-7a59-41dd-a4ed-af11d51ea935",

"deleted": false,

"createdDate": 1585545081671,

"lastModifiedDate": 0,

"systemModstamp": 0,

"email": "test20200305@casbqa1.onmicrosoft.com",

"userName": "test20200305@casbqa1.onmicrosoft.com",

"name": "test 20200305",

"firstName": "test",

"lastName": "20200305",

"service": "OFFICE365",

"lastLoginDate": 0,

"isActive": false

},

{

"companyId": "6",

"buId": 6384,

"userId": "2349ce5f-6bbc-42f9-957a-93dfda3e6e2e",

"origUserId": "2349ce5f-6bbc-42f9-957a-93dfda3e6e2e",

"deleted": false,

"createdDate": 1585545094771,

"lastModifiedDate": 0,

"systemModstamp": 0,

"email": "testuser@casbqa1.onmicrosoft.com",

"userName": "testuser@casbqa1.onmicrosoft.com",

"name": "test user0306",

"firstName": "test",

"lastName": "user0306",

"service": "OFFICE365",

"lastLoginDate": 0,

"isActive": false

},

{

"companyId": "6",

"buId": 6384,

"userId": "3dbc2c02-bfa5-4323-85ab-c37e4726e8ee",

"origUserId": "3dbc2c02-bfa5-4323-85ab-c37e4726e8ee",

"deleted": false,

"createdDate": 1585545030381,

"lastModifiedDate": 0,

"systemModstamp": 0,

"email": "internaluser@casbqa1.onmicrosoft.com",

"userName": "internaluser@casbqa1.onmicrosoft.com",

"name": "User Internal",

"firstName": "User",

"lastName": "Internal",

"service": "OFFICE365",

"lastLoginDate": 0,

"isActive": false

}

]