Skip to content

How one of the release's findings came about, and why

GET
/v1/orgs/{org}/releases/{release}/findings/{source}/{vuln_id}/timeline
curl --request GET \
--url https://example.com/v1/orgs/example/releases/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/findings/osv/example/timeline \
--header 'Authorization: Bearer <token>'

The finding’s timeline, computed when read: published upstream, in Affectra (first loaded), matched to this release, known exploited (the list’s date and ours, per CVE and list: CISA’s KEV or ENISA’s), and the organization’s VEX statements on it, oldest first. Times marked approx are upper bounds (“before”): records Affectra had before it recorded load times.

The cause, with F the first match in the release (never before the SBOM that brings it in), S the earliest of the release’s SBOMs with a matched component, and L the last logged load of the record’s feed (the matched components’ OSV data sets, or nvd) that started at or before F. The first that applies:

  • mapping: the first match came through the organization’s own CPE mapping or CSAF product mapping (named, with its creation time).
  • upload: S is no earlier than the record’s first load and, if there is L, than L’s start.
  • new_advisory: the record was first loaded in L (at: L’s end). Not for approximate load times.
  • advisory_changed: the record is older than L, which updated it (at: L’s end). What changed isn’t said.
  • unknown: none of these can be shown.

A record the release has no finding for is a 404, like another organization’s release.

org
required
string

Organization (tenant) slug, e.g. alpenrobotik

release
required
string format: uuid
source
required
string
Allowed values: osv nvd csaf
vuln_id
required
string

The finding’s record ID, e.g. “DSA-5343-1”, “CVE-2023-0286”, “siemens:SSA-104023” (csaf)

The timeline

Media typeapplication/json
object
source
required
string
Allowed values: osv nvd csaf
vuln_id
required
string
published
required

Published upstream

string | null format: date-time
modified
required

Last modified upstream

string | null format: date-time
loaded
required

When Affectra first had the record

object
at
required
string format: date-time
approx
required

At is an upper bound: show it as “before ”

boolean
uploaded_at
required

The earliest of the release’s SBOMs that brings the finding in

string format: date-time
matched_at
required

First matched to this release

string format: date-time
matched_via
required
string
Allowed values: purl cpe csaf_purl csaf_cpe org_cpe org_csaf
known_exploited
required

The record’s CVEs on an exploited list: CISA’s KEV catalog, or ENISA’s list (EU KEV) for entries from a source other than CISA. A CVE on both lists has an entry for each.

Array<object>
object
cve
required
string
list
required

Cisa: CISA’s KEV catalog; enisa: ENISA’s exploited list

string
Allowed values: cisa enisa
date_added

Added by the list

string format: date
first_seen
required

When Affectra first had the entry

object
at
required
string format: date-time
approx
required

At is an upper bound: show it as “before ”

boolean
euvd_ids
required

The EUVD IDs (ENISA’s EU Vulnerability Database, e.g. EUVD-2025-4893) of the record’s CVEs, sorted; empty when ENISA has none or this installation doesn’t sync the EUVD.

Array<string>
assessed
required

The organization’s VEX statements on the record or its CVEs for this release, oldest first

Array<object>
object
at
required
string format: date-time
vulnerability
required
string
status
required
string
Allowed values: not_affected affected fixed under_investigation
cause
required

Why the finding is there; the rules are in the operation’s description

object
kind
required
string
Allowed values: mapping upload new_advisory advisory_changed unknown
at

Mapping: created; upload: S; new_advisory, advisory_changed: the load’s end

string format: date-time
feed

New_advisory, advisory_changed: the source

string
Allowed values: osv nvd csaf
dataset

OSV data set, e.g. “Debian”, or CSAF provider, e.g. “siemens”

string
mapping

A CPE mapping has vendor and product; a CSAF product mapping provider, kind and value

object
purl
required
string
vendor
string
product
string
provider
string
kind

What of a CSAF product the value names

string
Allowed values: model_number sku product_name
value
string

Example

{
"source": "osv",
"matched_via": "purl",
"known_exploited": [
{
"list": "cisa"
}
],
"assessed": [
{
"status": "not_affected"
}
],
"cause": {
"kind": "mapping",
"feed": "osv",
"mapping": {
"kind": "model_number"
}
}
}

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.

Media typeapplication/problem+json

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
status
required

The HTTP status

integer
code
required

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.

string
Allowed values: notFound internal request.invalidJson request.invalid request.alreadyExists request.timeInvalid auth.required auth.csrfMissing email.invalid accounts.passwordUnavailable locale.invalid request.rateLimited auth.sessionRequired auth.roleTooLow auth.githubTokenUploadOnly org.suspended org.required request.fieldRequired request.textInvalid request.timeout server.notReady catalog.unavailable report.invalid report.wrongTenant settings.csafNamespaceInvalid settings.digestHourInvalid settings.timeZoneInvalid sbom.invalid sbom.limitExceeded sbom.signatureInvalid sbom.signatureRequired sbom.signatureUnavailable upload.hardwareRevisionRenamed upload.malformed upload.unexpectedPart upload.sbomMissing upload.tooLarge upload.unreadable provenance.invalid provenance.sbomAttestation provenance.signatureRequired provenance.unavailable vex.vulnerabilityInvalid vex.statusInvalid vex.justificationUnknown vex.justificationNotAllowed vex.justificationRequired vex.actionRequired vex.statementTooLong vex.csafNamespaceRequired vex.csafNoStatements release.hasVexStatements finding.refInvalid mapping.purlInvalid mapping.purlVersioned mapping.purlCoveredByOsv mapping.cpeFieldInvalid mapping.builtIn mapping.csafProviderUnknown mapping.csafKindInvalid mapping.csafValueInvalid feeds.notSubscribable accounts.setupEmailLimit member.exists member.joined member.roleInvalid member.ownerGrantDenied member.ownerChangeDenied member.ownerRemoveDenied member.lastOwner github.orgInvalid github.teamInvalid github.roleInvalid github.adminRequired key.nameInvalid key.roleInvalid key.purposeInvalid product.keyInvalid product.keyExists product.keyLocked product.supportEndsInvalid alias.reportedInvalid alias.exists publisher.repositoryInvalid publisher.fieldTooLong publisher.idsIncomplete publisher.repositoryNotFound publisher.githubUnreachable publisher.workflowInvalid publisher.refPatternPrefix publisher.refPatternInvalid publisher.exists graph.vulnerabilityUnknown graph.timeout proposal.evidenceUnknown proposal.evidenceTooLarge proposal.kindInvalid proposal.basisInvalid proposal.notCarryOver proposal.basisMismatch proposal.notPending proposal.sourceSuperseded proposal.ownProposal proposal.fourEyes proposal.personRequired proposal.batchTooLarge proposal.vulnerabilityChanged proposal.reportedChanged proposal.releaseUnknown proposal.evidenceMissing notifications.unavailable notifications.findingsInvalid notifications.tokenInvalid webhook.urlRejected webhook.limitReached webhook.formatUnavailable webhook.headerInvalid webhook.eventTypesInvalid webhook.disabled events.cursorInvalid
detail
required

What went wrong

string
params
required

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
key
additional properties
any

Example

{
"code": "notFound"
}
Retry-After
integer
>= 1

Seconds until a request would be allowed again, at least 1