Retrieve an account

Request

Security

x-api-key

Path

idstringrequired

Unique identifier for the account

GET

/v1/accounts/{id}

curl -i -X GET \
  'https://api.pushsecurity.com/v1/accounts/{id}' \
  -H 'x-api-key: YOUR_API_KEY_HERE'

Responses

Headers

any

Bodyapplication/json

idstring

Unique identifier for the account

Example:"d6a32ba5-0532-4a66-8137-48cdf409c972"

employeeIdstring

Identifier of primary employee that this account belongs to

Example:"72d0347a-2663-4ef5-b1c5-df39163f1603"

appTypestring

The app associated with this account

Example:"ATLASSIAN"

appIdstring

The ID of the app associated with this account

Example:"2a2197de-ad2c-47e4-8dcb-fb0f04cf83e0"

emailstring, (email)

The email address used to log into the account

Example:"john.hill@example.com"

mfaRegisteredboolean or null

Whether MFA is registered or not. If unknown, null is provided.

Example:true

mfaMethodsArray of strings or null

The MFA methods registered for this account

passwordIdstring or null

Identifier of the password used on this account. The actual password is not sent up by the browser extension and so this is an identifier for it instead. This value is null if password authentication is not used.

Example:"4c13674f-e88a-4411-bfa2-53a70468a898"

loginMethodsobject

creationTimestampinteger

When this account was created, formatted as a UNIX timestamp (in seconds)

Example:1698064423

lastUsedTimestampinteger or null

When the account was last used by an employee, formatted as a UNIX timestamp (in seconds)

Example:1698669168

Response

{
  "id": "d6a32ba5-0532-4a66-8137-48cdf409c972",
  "employeeId": "72d0347a-2663-4ef5-b1c5-df39163f1603",
  "appType": "ATLASSIAN",
  "appId": "2a2197de-ad2c-47e4-8dcb-fb0f04cf83e0",
  "email": "john.hill@example.com",
  "mfaRegistered": true,
  "mfaMethods": [
    "APP_TOTP"
  ],
  "passwordId": "4c13674f-e88a-4411-bfa2-53a70468a898",
  "loginMethods": {
    "passwordLogin": true,
    "lastPasswordLoginTimestamp": 1698064423,
    "oidcLogin": "GOOGLE_WORKSPACE",
    "lastOidcLoginTimestamp": 1698064423,
    "samlLogin": "OKTA",
    "lastSamlLoginTimestamp": 1698064423,
    "oktaSwaLogin": true,
    "lastOktaSwaLoginTimestamp": 1698064423,
    "vendorSsoLogin": "GOOGLE_WORKSPACE",
    "fedCmLogin": "GOOGLE_WORKSPACE",
    "lastFedCmLoginTimestamp": 1698064423
  },
  "creationTimestamp": 1698064423,
  "lastUsedTimestamp": 1698669168
}