# isMalicious Surveillance API

**Canonical:** https://apis.io/apis/ismalicious-com/ismalicious-com-surveillance-api/  
**Provider:** isMalicious — https://apis.io/providers/ismalicious-com/  
**Base URL:** https://api.ismalicious.com  
**Documentation:** https://ismalicious.com/api

isMalicious Surveillance API is one of 19 APIs that [isMalicious](https://apis.io/providers/ismalicious-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 2 JSON Schema definitions. Tagged areas include Surveillance. The published artifact set on APIs.io includes an OpenAPI specification and 2 JSON Schemas.

Vulnerability monitoring of the organisation's stack: watched sources (a domain, a lockfile/SBOM project, a manual stack), findings with the affected range and the fix, the alert policy. API key or session; the unit is the watched source, not the request

## Operations (21)

| Method | Path | Summary |
|---|---|---|
| POST | `/surveillance/analyze` | Read a domain or parse a lockfile without saving anything |
| GET | `/surveillance/catalog/products` | Resolve a product name to watchable identities (no CPE knowledge needed) |
| DELETE | `/surveillance/components/{id}` | Remove a component |
| PATCH | `/surveillance/components/{id}` | Set a component's version or branch, or stop monitoring it |
| GET | `/surveillance/exposure` | What touches the organisation's stack now, by proof |
| GET | `/surveillance/findings` | Findings, filtered and paged |
| POST | `/surveillance/findings/bulk-status` | Triage up to 200 findings at once |
| GET | `/surveillance/findings/{id}` | One finding with the why and the fix of each component |
| PATCH | `/surveillance/findings/{id}` | Triage a finding (acknowledge, snooze, patched, not affected, accepted risk) |
| GET | `/surveillance/policy` | The organisation's alert policy |
| PUT | `/surveillance/policy` | Update the alert policy |
| POST | `/surveillance/policy/test` | Send a test notification to one channel, now |
| POST | `/surveillance/preview` | Expected alert volume over the last 90 days, and what needs action today |
| GET | `/surveillance/quota` | Sources used and allowed on the served plan |
| GET | `/surveillance/sources` | List the organisation's watched sources and the source quota |
| POST | `/surveillance/sources` | Watch a domain, a lockfile/SBOM project or a manual stack |
| GET | `/surveillance/sources/{id}` | One source with its components |
| DELETE | `/surveillance/sources/{id}` | Stop watching a source (its components and their links go with it) |
| PATCH | `/surveillance/sources/{id}` | Rename, describe, pause or resume a source |
| POST | `/surveillance/sources/{id}/components` | Add components to a source |
| POST | `/surveillance/sources/{id}/refresh` | Re-read a domain now, or re-upload a lockfile |

## Machine-readable artifacts (3)

- **OpenAPI** — https://artifacts.apis.io/ismalicious-com/openapi/ismalicious-com-surveillance-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/ismalicious-com/json-schema/ismalicious-com-create-source-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/ismalicious-com/json-schema/ismalicious-com-exposure-response-schema.json

## Other isMalicious APIs (12)

- [isMalicious Action Center API](https://apis.io/apis/ismalicious-com/ismalicious-com-action-center-api/)
- [isMalicious Alerts API](https://apis.io/apis/ismalicious-com/ismalicious-com-alerts-api/)
- [isMalicious Blocklist API](https://apis.io/apis/ismalicious-com/ismalicious-com-blocklist-api/)
- [isMalicious Briefs API](https://apis.io/apis/ismalicious-com/ismalicious-com-briefs-api/)
- [isMalicious Cases API](https://apis.io/apis/ismalicious-com/ismalicious-com-cases-api/)
- [isMalicious Check API](https://apis.io/apis/ismalicious-com/ismalicious-com-check-api/)
- [isMalicious Cve API](https://apis.io/apis/ismalicious-com/ismalicious-com-cve-api/)
- [isMalicious Gate API](https://apis.io/apis/ismalicious-com/ismalicious-com-gate-api/)
- [isMalicious Mail API](https://apis.io/apis/ismalicious-com/ismalicious-com-mail-api/)
- [isMalicious Monitoring API](https://apis.io/apis/ismalicious-com/ismalicious-com-monitoring-api/)
- [isMalicious Platform API](https://apis.io/apis/ismalicious-com/ismalicious-com-platform-api/)
- [isMalicious Ransomware API](https://apis.io/apis/ismalicious-com/ismalicious-com-ransomware-api/)

## Tags

Surveillance

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/ismalicious-com/ismalicious-com-surveillance-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/ismalicious-com/.