The vulnerability feeds and whether the organization uses them
const url = 'https://example.com/v1/orgs/example/feeds';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://example.com/v1/orgs/example/feeds \ --header 'Authorization: Bearer <token>'Every feed this installation syncs, and every feed the organization can turn on or off (NVD and each CSAF provider), in display order: OSV, NVD, the CSAF providers, then the enrichment feeds. OSV is one entry for all its data sets; its checked_at is the oldest among them. OSV and the enrichment feeds (kev, eukev, euvd, epss, cwe, capec, attack) are always on. state and checked_at say how fresh the feed is, as data freshness does; error texts and failure counts are for the operator only.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Organization (tenant) slug, e.g. alpenrobotik
Responses
Section titled “Responses”Feeds
object
Osv, nvd, csaf:
How the feed is shown, e.g. NVD, Siemens ProductCERT
Matching feeds create findings (OSV, NVD, CSAF); enrichment feeds add context to them
The organization can turn it on or off (NVD and the CSAF providers)
Its findings count for the organization; always true for a feed that isn’t subscribable
Whether it is on for an organization that never chose
A CSAF provider: a vendor’s own advisories or a coordinator’s; null for the other feeds
Last successful check; null when never checked or not synced here
When the organization last turned it on or off; null if it never did
Who did: the user’s ID, or api-key; null if nobody did
Example
[ { "kind": "matching", "publisher": "vendor", "state": "ok" }]No such object in this organization, no such organization, or the caller does not belong to it
Over the operation’s rate-limit budget (x-affectra-budget): code request.rateLimited with params.budget. Wait Retry-After seconds before trying again.
Every error answer, Content-Type
application/problem+json. The web app and integrations translate code; detail is English,
for people reading curl output or CI logs, and may change wording at
any time. Match on code, never on detail.
object
The HTTP status
Stable error codes. A code is never renamed; new ones may be added, so
a client falls back to detail for a code it doesn’t know. Another
organization’s object answers notFound, the same as a missing one.
What went wrong
Values the code’s message needs, e.g. {“field”: “version”}. Only values the caller sent or may see. Empty when the message needs none.
object
Example
{ "code": "notFound"}Headers
Section titled “Headers”Seconds until a request would be allowed again, at least 1
The server runs without a database or object storage; the catalog is unavailable