Get or search findings for your MSP sub-account
Request
- Base URL: https://api.blumira.com/public-api/v1
- URL: https://api.blumira.com/public-api/v1/msp/accounts/{account_id}/findings
- Auth: HTTP bearer
Path parameters
Account ID of the object, e.g., "00110011-0000-0000-0000-000000000000"
Query parameters
Page to return, e.g., "2"
Number of records per page to return, e.g., "3"
Maximum number of records to return, e.g., "200"
Order records by field, e.g., "created", "created;asc", "created;desc", "name;desc,created;desc"
If included, filter findings with blocked either True of False
If included, filter findings with blocked either True of False
If included, filter out findings with blocked either True of False
Category ID of finding
Category ID of finding
Category ID of finding to filter out
Comma-separated list of category IDs of findings to include
Comma-separated list of category IDs of findings to filter out
Exact time object was created
Start time of window for search (implied UTC)
End time of window for search (implied UTC)
Exact time object was created
Filter out findings with the given exact time of creation
End time of window for search (implied UTC) (exclusive)
Start time of window for search (implied UTC) (inclusive)
Start time of window for search (implied UTC) (exclusive)
End time of window for search (implied UTC) (inclusive)
If specified, limit search to findings created_by person with given UUID
Exact time object was modified
Start time of window for search (implied UTC)
End time of window for search (implied UTC)
Exact time object was modified
Filter out findings with the given exact time of modification
End time of window for search (implied UTC) (exclusive)
Start time of window for search (implied UTC) (inclusive)
Start time of window for search (implied UTC) (exclusive)
End time of window for search (implied UTC) (inclusive)
UUID of person who last modified finding
UUID of person who last modified finding
Filter out findings where person who last modified it has the given UUID
Comma-separated list of UUIDs of persons who last modified finding
Filter out findings where person who last modified it in the given comma-separated list of UUIDs
If specified, will limit search to findings with given name
If specified, will limit search to findings with given name
If specified, will filter out findings with given name
If specified, will limit search to findings with one of the given comma-separated list of names
If specified, will filter out findings with any of the given comma-separated list of names
If specified, will limit search to findings with given name substring
If specified, will filter out findings with given name substring
If specified, will limit search to findings with name partially matching given regular expression
If specified, will filter out findings with name partially matching given regular expression
Priority number of finding
Priority number of finding
Priority number of finding to filter out
Comma-separated list of priority numbers of findings to include
Comma-separated list of priority numbers of findings to filter out
Minimum priority number of finding to exclude
Minimum priority number of finding to include
Maximum priority number of finding to exclude
Maximum priority number of finding to include
Resolution ID of finding
Resolution ID of finding
Resolution ID of finding to filter out
Comma-separated list of Resolution IDs of findings to include
Comma-separated list of resolution IDs of findings to filter out
Status ID of finding
Status ID of finding
Status ID of finding to filter out
Comma-separated list of status IDs of findings to include
Comma-separated list of status IDs of findings to filter out
UUID of person who last modified finding status
UUID of person who last modified finding status
UUID of person who last modified finding status
Comma-separated list of UUIDs of persons who last modified finding status
Comma-separated list of UUIDs of persons who last modified finding status to be filtered out
Integer type id
Integer type id
Integer type id to filter out
Comma-separated list of integer type IDs to include
Comma-separated list of integer type IDs to filter out
Headers
Bearer followed by JWT, e.g., "Bearer eyJh...enA"
Response
A list of findings for your MSP sub-account
Example response
{
"data": [
{
"analysis": "Blumira has detected a portscan from 192.168.26.121 to 192.168.2.203 over 1, 4, 37, 9, and 2 others port(s) from an advanced raw query detector.",
"created": "2015-07-07T15:49:51.230",
"finding_id": "aff08432-80ae-8fbe-bcd0-399beb09c6f1",
"modified": "2015-07-07T15:49:51.230",
"name": "Active Directory Domain Admin Created",
"org_id": "aff08432-80ae-8fbe-bcd0-399beb09c6f1",
"org_name": "My Organization",
"priority": 4,
"short_id": "F-24-16-B4B6",
"status": 40,
"status_name": "Open",
"type_name": "Suspect",
"ui_action_type": 20,
"category_name": "Malicious Code",
"jurisdiction_name": "administrator",
"resolution": 10,
"resolution_name": "Valid",
"summary": "Detects potentially innapropriately created domain administrators through Event ID.",
"url": "https://app.blumira.com/f0eee000-0000-0000-0000-c0ffee000001/query/findings/ffffffff-1111-2555-0000-000000000001"
}
],
"links": {
"next": "/v1/{path}?page=2&page_size=25",
"self": "/v1/{path}?page=1&page_size=25"
},
"meta": {
"page": 1,
"page_size": 100,
"total_items": 156,
"total_pages": 2
},
"status": "OK"
}Changes
No recorded changes to this operation across all 1 revision of this API.