Skip to content
/
List browsers

List browsers

Request

Retrieve a list of browser objects

Security
x-api-key
Query
emailstring

Filter by email address. Accepts partial email addresses for wildcard searches.

employeeIdstring

Filter by employee ID.

browserany(BrowserType)

Filter by browser name.

Enum:"CHROME""FIREFOX""EDGE""SAFARI""OPERA""BRAVE""ARC""ISLAND""PRISMA_ACCESS""ATLAS"
osany(OSType)

Filter by operating system name.

Enum:"MACOS""WINDOWS""LINUX""CHROME_OS""IOS""ANDROID""UNKNOWN"
lastOnlineTimestampAfterinteger

Filter by when the browser was last used by an employee - start time. This is a UNIX timestamp (in seconds).

lastOnlineTimestampBeforeinteger

Filter by when the browser was last used by an employee - end time. This is a UNIX timestamp (in seconds).

limitinteger, [ 1 .. 500 ]

Used for pagination. Number of objects to return.

Default:500
offsetintegerdeprecated

Used for pagination. Number of objects to skip. Cannot be set when nextToken is also set.

nextTokenstring

Used for pagination. Token to be used for the next request. Cannot be set when offset is also set.

GET
/v1/browsers
curl -i -X GET \
  https://api.pushsecurity.com/v1/browsers \
  -H 'x-api-key: YOUR_API_KEY_HERE'

Responses

OK

Bodyapplication/json
resultArray of objects(Browser)
pagingobject
Response
{
  "result": [
    {
      "id": "1852b6ab-0cca-4c8d-8f14-4905497504ec",
      "employeeId": "2a2197de-ad2c-47e4-8dcb-fb0f04cf83e0",
      "email": "john.hill@example.com",
      "version": "125.0.0.0",
      "tokenType": "INDIVIDUAL",
      "isActive": true,
      "browser": "CHROME",
      "os": "MACOS",
      "extensionVersion": "1.66.17",
      "language": "en-US",
      "profileEmail": "john.hill@example.com",
      "profileSyncEnabled": true,
      "creationTimestamp": 1698669223,
      "lastOnlineTimestamp": 1716290202
    }
  ],
  "paging": {
    "moreResults": true,
    "next": "501",
    "nextToken": "0b9972aa-fe8d-4095-82d3-2e13cf3cfd43"
  }
}