Skip to main content

getAllCompanyIdentities

Use this method to retrieve all detected identities for a company.

Parameters

Name

Description

Included in request

Type

Values

searchString

A text value used to search and return only the identities whose names match the specified string.

Optional

String

No additional requirements.

If not included, the response will include all identities.

These are common parameters, available across all public API methods.

Parameter

Description

Included in request

Type

Values

id

This parameter adds an identifier to the request, linking it to its corresponding response.

The target replies with the same value in the response, allowing easy call tracking.

Mandatory

String

No additional requirements

method

The name of the method you are using to send the request.

Mandatory

String

Must be a valid method name.

jsonrpc

The version of JSON-RPC used by the request and the response.

Mandatory

Integer

Possible values:

  • 2.0

params

An object containing the configuration of the request.

Mandatory

Object

No additional requirements.

Under the params object

page

The results page number.

Optional

Integer

Default value: 1

perPage

The number of results displayed per page.

Optional

Integer

The upper limit is 100 items per page.

Default value: 30

Return value

Attribute

Type

Description

items

Array of objects

Each object contains information on a identity.

Objects

items

Attribute

Type

Description

behavioralProfileidentity

String

The ID of the identity.

behavioralProfileidentityName

String

The name of the identity.

Example

Request:

{
  "params": {
    "companyId": "67fe8595d4db0d536908ec92",
    "page": 1,
    "perPage": 10,
    "searchString": "BDAdmin"
  },
  "jsonrpc": "2.0",
  "method": "getAllCompanyIdentities",
  "id": "b7e2c1d4-9f8a-4c2e-8b1a-ef1234567890"
}

Response:

{
  "id": "b7e2c1d4-9f8a-4c2e-8b1a-ef1234567890",
  "jsonrpc": "2.0",
  "result": [
    "page": 1,
    "pagesCount": 1,
    "perPage": 20,
    "total": 10,
    "items": [
      {
        "behavioralProfileidentity": "376f7eff-b0d7-49b2-825b-2af1c0f1aede-b545e199a29e",
        "behavioralProfileidentityName": "AutoTestWin-24c6n"
      },
      {
        "behavioralProfileidentity": "3d2dd1ac-d170-4be0-8691-69a549f9df67-499dd90e3d7d",
        "behavioralProfileidentityName": "AutoTestWin-q7dmj"
      },
      {
        "behavioralProfileidentity": "b655e398-3c71-4be8-a4af-0006d8dde22d-b8d3ad357b1a",
        "behavioralProfileidentityName": "AutoTestWin-rhluh"
      },
      {
        "behavioralProfileidentity": "d5cff268-b67c-4cad-90c8-ff2742f3bf43-47146daa1909",
        "behavioralProfileidentityName": "AutoTestWinSpecialV1-bsd6i"
      },
      {
        "behavioralProfileidentity": "cc7f0156-0f86-4a73-9fa6-ef2022eb5b84-84852c001b54",
        "behavioralProfileidentityName": "AutoTestWinSpecialV1-gdtqn"
      },
      {
        "behavioralProfileidentity": "6fb6e145-903e-442f-ae6a-ae3b221132d7-e6e3a2e60257",
        "behavioralProfileidentityName": "AutoTestWinSpecialV1-lf9ru"
      },
      {
        "behavioralProfileidentity": "78746acd-5527-4d12-b2c7-bb122819dea6-a414d927d168",
        "behavioralProfileidentityName": "AutoTestWinSpecialV1-s49bj"
      },
      {
        "behavioralProfileidentity": "2f2c1642-d190-b971-32fc-56f667db7b33-0050569662d8",
        "behavioralProfileidentityName": "DESKTOP-Q2C86HV"
      },
      {
        "behavioralProfileidentity": "00000000-0000-0000-0000-100000000001",
        "behavioralProfileidentityName": "TEST_ENDPOINT_WINDOWS_10"
      },
      {
        "behavioralProfileidentity": "00000000-0000-0000-0000-100000000003",
        "behavioralProfileidentityName": "TEST_ENDPOINT_WINDOWS_103"
      }
    ]
  ]
}