Spotlight
Spotlight vulnerabilities is the Spotlight collection for this CID —
query/get only. Paths are under /spotlight/…. Combined
vulnerabilities, remediations, after cursor pagination, and Intel
extras are not implemented. There is no create or patch.
Quarantine is a separate collection:
Quarantine. Real Time Response is a separate
collection: Real Time Response.
This collection is not CrowdStrike production. It does not call Falcon cloud.
RPC field notes: SpotlightService. REST schemas: API reference. Filter syntax: FQL.
These curls use Host: crowdstrike-api.localhost against Compose
Traefik on :8088. If the hostname already resolves to Traefik, you can
omit the Host header and call http://crowdstrike-api.localhost instead.
Auth
Every call needs a console session or a Bearer token:
- Cookie
cs_consolefromCreateSession(POST /identity/entities/sessions/v1) Authorization: Bearerwithspotlight-vulnerabilities:readfor query and get
A session cookie bypasses OAuth scopes. Seed client cs-local-hosts
(hosts:read only) cannot query vulnerabilities (403). There is no
seeded client with spotlight-vulnerabilities:read — use the console
cookie, or a client you created with that scope. Missing or revoked
token → 401.
HTTP paths
| Method | Path | Use |
|---|---|---|
GET | /spotlight/queries/vulnerabilities/v1 | Query vulnerability ids. Query: filter, limit, offset, sort (cve_id.asc / cve_id.desc / severity.asc / status.asc and matching .desc). Empty filter returns all ids. |
GET | /spotlight/entities/vulnerabilities/v2?ids= | Get vulnerabilities. Missing id → 200 with only found resources. |
Allowed FQL properties: cve_id, severity, status (match is
lowercase). Nested cve.id is not accepted. Unknown property or
invalid filter → 400.
Vulnerability JSON: id, cve_id, severity, status.
Get is GET with query ids — not POST GET.
Seed vulnerabilities
id | cve_id | severity | status |
|---|---|---|---|
vuln-cve-2024-0001 | CVE-2024-0001 | high | open |
vuln-cve-2024-0002 | CVE-2024-0002 | medium | open |
Session cookie
curl -sS -c cookies.txt -H 'Host: crowdstrike-api.localhost' \
-H 'Content-Type: application/json' \
-d '{"email":"[email protected]","password":"FalconLocal!1","cloud":"us-1"}' \
http://127.0.0.1:8088/identity/entities/sessions/v1
Query vulnerabilities (cookie)
Empty filter returns at least the seed ids vuln-cve-2024-0001 and
vuln-cve-2024-0002. severity:'high' returns CVE-2024-0001:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/spotlight/queries/vulnerabilities/v1?filter=severity:%27high%27'
Invalid FQL is 400:
curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/spotlight/queries/vulnerabilities/v1?filter=not-fql'
Get vulnerabilities (cookie)
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/spotlight/entities/vulnerabilities/v2?ids=vuln-cve-2024-0001'
Combined, remediations, and after cursor pagination are not
implemented. Intel actors are a separate collection:
Intel actors. Intel indicators are a separate
POST GET collection: Intel indicators. Quarantine
is a separate collection: Quarantine. Real
Time Response is a separate collection:
Real Time Response.
Query (Bearer)
TOKEN='<access_token from a client with spotlight-vulnerabilities:read>'
curl -sS -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/spotlight/queries/vulnerabilities/v1'
spotlight-vulnerabilities:read → 200. A token without that scope
(including hosts:read only) → 403. Missing or revoked token →
401.
OAuth2 mint/revoke: OAuth2. Accessible scopes: API clients.