https://api.bitsighttech.com/ratings/v1/users/user_guid
Version 2 is now available.
Use this to get account details of a user in your organization.
Alternatively, /v1/users/current queries your user account.
Parameters
* Required.
- user_guid
-
* Required.
[Path] Identify the user to query.
Value: [String] User unique identifier [
user_guid]. See GET: Users.
Example Request
curl 'https://api.bitsighttech.com/ratings/v1/users/ffffffff-cccc-4444-4444-fffcccfffccc' -u api_token:
Example Response
{
⊕ GET: Users
"date_joined":"2018-05-21T19:15:01Z",
"product_access":[
⊗ For Internal Bitsight Use
],
"customer":{
"guid":"12345678-abcd-1234-abcd-1234567890ab",
"name":"Example",
"my_company_guid":"aaaabbbb-1122-3344-cccc-dddd55555eee",
"my_company_subsidiaries":[
"12312312-abcd-abcd-1234-abcabcabcabc",
"babababa-1212-abab-1212-abababababab"
],
"show_partner_logo":false,
"partner":null,
"sales_manager":null,
"has_mobile_risk":false,
"is_federal_agency":false,
"has_accepted_federal_agency_disclaimer":false
},
"group":{
"guid":"ffffffff-cccc-4444-4444-fffcccfffccc",
"name":"All Companies"
},
"last_login":"2020-01-17T18:45:25Z",
"last_login_excluding_current":{
"ipaddress":"65.244.21.162",
"time":"2020-01-17T15:29:17Z"
},
"features":{
⊗ For Internal Bitsight Use
},
"roles":[
{
"name":"Customer Admin",
"presentation":"Admin",
"permissions":[
⊕ User Permissions
]
}
],
"permissions":[
⊕ User Permissions
],
"has_accepted_darkweb":false,
"release_notes_unseen_count":0,
"country_entities_count":25,
"homepage_url":"/dashboard/"
}
Response Attributes
| Field | Description | |
|---|---|---|
date_joined String [ |
The date and time when this user’s account was created. | |
product_access Array |
For internal Bitsight use. | |
customer Object |
Details of your organization’s Bitsight account. | |
guid String [ |
The unique identifier of your organization’s Bitsight account. | |
name String |
The name of your organization’s Bitsight profile. | |
my_company_guid String [ |
The unique identifier of your company. | |
my_company_subsidiaries Array [ |
The unique identifiers of companies in your organization. | |
show_partner_logo Boolean |
For internal Bitsight use. | |
partner String |
For internal Bitsight use. | |
sales_manager String |
For internal Bitsight use. | |
has_mobile_risk Boolean |
For internal Bitsight use. | |
is_federal_agency Boolean |
true = Your organization is a federal agency. |
|
has_accepted_federal_agency_disclaimer Boolean |
For internal Bitsight use. | |
group Object |
Contains details of this user's Access Control Group. | |
guid String [ |
The unique identifier of this user’s group. | |
name String |
The name of this user’s group. | |
last_login String [ |
The date and time when this user last logged into the Bitsight platform. | |
last_login_excluding_current Object |
Details of this user's previous session in the platform. | |
ipaddress String |
The IP address used to log in to the Bitsight platform. | |
time String [ |
The date and time when this user last logged into the Bitsight platform. | |
features Object |
Bitsight platform features that are enabled for this user. | |
roles Array |
Details of this user’s role. See user roles. | |
name String |
The name of this role. | |
presentation String |
The name of this role, as displayed in the Bitsight platform. | |
permissions Array |
The permissions of this role. | |
permissions Array |
This user’s permissions. | |
has_accepted_darkweb Boolean |
true = The Dark Web feature is enabled for this user. |
|
release_notes_unseen_count Integer |
[Deprecated] The number of unread release notes. | |
country_entities_count Integer |
The number of countries that are being monitored in this user’s National Cybersecurity account. | |
homepage_url String |
The path to this user’s landing page in the Bitsight platform. | |
- May 20, 2020: Published.
Feedback
0 comments
Please sign in to leave a comment.