Skip to content

Findings

These objects represent the findings that have been found in your organization.

Operations

List findings

Request

Security
x-api-key
Query
statestring

Filter by finding state.

typestring

Filter by the type of finding.

employeeIdstring

Filter by the employee associated with the finding.

appTypestring

Filter by the app that is associated with the finding.

accountIdstring

Filter by the account that is associated with the finding.

passwordIdstring

Filter by the password identifier that is associated with the finding.

creationTimestampAfterstring

Filter by when the finding was first observed - start time. This is a UNIX timestamp (in seconds).

creationTimestampBeforeinteger

Filter by when the finding was first observed - 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/findings
curl -i -X GET \
  https://api.pushsecurity.com/v1/findings \
  -H 'x-api-key: YOUR_API_KEY_HERE'

Responses

OK

Bodyapplication/json
resultArray of objects(Finding)
pagingobject
Response
{
  "result": [
    {
      "id": "d6a32ba5-0532-4a66-8137-48cdf409c972",
      "type": "MFA_NOT_REGISTERED",
      "state": "OPEN",
      "employeeId": "379ac7ea-ff2a-42ef-af37-06d2020dc46a",
      "passwordId": "c4a045a1-5331-4714-af83-6a361e98960d",
      "accountId": "string",
      "appType": "PUSH_SECURITY",
      "appId": "2a2197de-ad2c-47e4-8dcb-fb0f04cf83e0",
      "weakPasswordReasons": [
        "COMMON_BASE_WORD"
      ],
      "creationTimestamp": 1698064423
    }
  ],
  "paging": {
    "moreResults": true,
    "next": "501",
    "nextToken": "0b9972aa-fe8d-4095-82d3-2e13cf3cfd43"
  }
}