Get my requests
This method returns a list of the end user's requests.
URL
-
Make sure there are no spaces in the URL.
-
The following characters are not supported in URL values: + & %
-
If the URL includes a dot (.), add a forward slash (/) at the end of the URL. For example: api/Safes/MySafe/Members/user@cyber.com/
|
The following mandatory values are required in the URL:
|
Parameter |
OnlyWaiting |
|
Type |
Boolean |
|
Description |
Only requests waiting for approval will be listed. |
|
Valid values |
true/false |
|
Default |
false |
|
Parameter |
Expired |
|
Type |
Boolean |
|
Description |
Expired requests will be included in the list. |
|
Valid values |
true/false |
|
Default |
false |
Resource information
|
HTTP method |
GET |
|
Content type |
application/json |
Header parameter
|
Parameter |
Description |
|---|---|
|
Authorization |
The token that identifies the session, encoded in BASE 64. See Authentication. Type: String Mandatory: Yes Default value: None |
Body parameters
None
Result
|
|
Parameter |
RequestID |
|||||||||
|
Type |
Text |
|||||||||
|
Description |
The request's unique ID, composed of the SafeName and internal RequestID. |
|||||||||
|
Parameter |
SafeName |
|||||||||
|
Type |
Text |
|||||||||
|
Description |
The name of the Safe where the account being requested is stored . |
|||||||||
|
Parameter |
RequestorUserName |
|||||||||
|
Type |
Text |
|||||||||
|
Description |
The requestor's user name. |
|||||||||
|
Parameter |
RequestorReason |
|||||||||
|
Type |
Text |
|||||||||
|
Description |
The requestor's reason for accessing the account, and any additional information. |
|||||||||
|
Parameter |
UserReason |
|||||||||
|
Type |
Text |
|||||||||
|
Description |
The reason why the user is requesting access to the account. |
|||||||||
|
Parameter |
CreationDate |
|||||||||
|
Type |
Integer |
|||||||||
|
Description |
The time when the request was created, in Unix time. |
|||||||||
|
Parameter |
Operation |
|||||||||
|
Type |
Text |
|||||||||
|
Description |
Requestor's description of the operation to perform. |
|||||||||
|
Parameter |
ExpirationDate |
|||||||||
|
Type |
Integer |
|||||||||
|
Description |
The time when the request will expire, in Unix time. |
|||||||||
|
Parameter |
OperationType |
|||||||||
|
Type |
Integer |
|||||||||
|
Description |
The operation that was requested: |
|||||||||
|
Parameter |
AccessType |
|||||||||
|
Type |
Text |
|||||||||
|
Description |
Whether the request is for single or multiple access. |
|||||||||
|
Parameter |
ConfirmationsLeft |
|||||||||
|
Type |
Integer |
|||||||||
|
Description |
The number of confirmers who still need to respond to the request. |
|||||||||
|
Parameter |
AccessFrom |
|||||||||
|
Type |
Integer |
|||||||||
|
Description |
The time from when the account is needed, in Unix time. |
|||||||||
|
Parameter |
AccessTo |
|||||||||
|
Type |
Integer |
|||||||||
|
Description |
The time until when the account is needed, in Unix time. |
|||||||||
|
Parameter |
Status |
|||||||||
|
Type |
Integer |
|||||||||
|
Description |
The request status: |
|||||||||
|
Parameter |
StatusTitle |
|||||||||
|
Type |
Text |
|||||||||
|
Description |
A description of the request status. |
|||||||||
|
Parameter |
InvalidRequestReason |
|||||||||
|
Type |
Integer |
|||||||||
|
Description |
If the request is invalid, this indicates what caused it to become invalid: |
|||||||||
|
Parameter |
CurrentConfirmationLevel |
|||||||||
|
Type |
Integer |
|||||||||
|
Description |
The current confirmation level - either level 1 or level 2. |
|||||||||
|
Parameter |
RequiredConfirmersCountLevel2 |
|||||||||
|
Type |
Integer |
|||||||||
|
Description |
The number of confirmers left to respond at level 2. |
|||||||||
|
TicketingSystemProperties |
||||||||||
|
Parameter |
Name |
|||||||||
|
Type |
Text |
|||||||||
|
Description |
The name of the ticketing system. |
|||||||||
|
Parameter |
Number |
|||||||||
|
Type |
Integer |
|||||||||
|
Description |
Ticket number |
|||||||||
|
Parameter |
Status |
|||||||||
|
Type |
Integer |
|||||||||
|
Description |
Ticket status
|
|||||||||
|
AdditionalInfo |
||||||||||
|
Parameter |
Reference No |
|||||||||
|
Type |
Integer |
|||||||||
|
Description |
The unique reference number of this request. |
|||||||||
|
Parameter |
Emergency |
|||||||||
|
Type |
Boolean |
|||||||||
|
Description |
Whether or not this request is critical. |
|||||||||
|
AccountDetails |
||||||||||
|
Parameter |
AccountID |
|||||||||
|
Type |
Text |
|||||||||
|
Description |
An internal account ID, composed of SafeID and ObjectID. |
|||||||||
|
Properties |
||||||||||
|
Parameter |
Name |
|||||||||
|
Type |
Text |
|||||||||
|
Description |
The name of the account in the Vault. |
|||||||||
|
Parameter |
Folder |
|||||||||
|
Type |
Text |
|||||||||
|
Description |
The folder where the account is stored in the Vault. |
|||||||||
|
Parameter |
Safe |
|||||||||
|
Type |
Text |
|||||||||
|
Description |
The Safe where the account is stored in the Vault. |
|||||||||
|
Parameter |
Address |
|||||||||
|
Type |
Text |
|||||||||
|
Description |
The address of the machine where the account is used (IP or machine name). |
|||||||||
|
Parameter |
UserName |
|||||||||
|
Type |
Text |
|||||||||
|
Description |
The name of the user who will use the account. |
|||||||||
|
Parameter |
LastUsedDate |
|||||||||
|
Type |
Integer |
|||||||||
|
Description |
The last time the account was used, in Unix time. |
|||||||||
Return codes
For a complete list of return codes, see Return Codes.
