Api referenceFindings

List Findings

Reference for List Findings in the Veriom v1 API, including request, response, and authentication details.

GET/v1/workspaces/{workspace_id}/findings

List Findings. Returns a typed response and a request ID for operational support.

Authorization

veriom_session<token>

Opaque HttpOnly customer session. Mutations also require X-CSRF-Token.

In: cookie

Path Parameters

workspace_id*Workspace Id
Formatuuid

Query Parameters

cursor?string|null
limit?Limit
Default50
Range1 <= value <= 100
severity?|null
status?|null
repository_id?|null
architecture_disposition?|
Default"actionable"
sort?Sort
Default"newest"
Value in"newest" | "oldest" | "risk_desc" | "risk_asc"

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/v1/workspaces/497f6eca-6276-4993-bfeb-53cbbbba6f08/findings"
{
  "has_more": false,
  "items": [
    {
      "architecture_confidence": "0",
      "architecture_disposition": "pending",
      "architecture_impact": "critical",
      "audit_id": "78c04fa6-cfb4-46a0-9aa5-3681ba4f3897",
      "auto_disposition": false,
      "component_identity": "string",
      "cvss_score": "string",
      "evidence_revision": "string",
      "fingerprint_algorithm_version": "finding-v1",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "identity_fingerprint": "string",
      "last_seen_at": "2019-08-24T14:15:22Z",
      "lifecycle_started_at": "2019-08-24T14:15:22Z",
      "lifecycle_state": "new",
      "lifecycle_updated_at": "2019-08-24T14:15:22Z",
      "lifecycle_version": 1,
      "locations": [
        {}
      ],
      "owner_id": "8826ee2e-7933-4665-aef2-2393f84a0d05",
      "repository_id": "b349ae61-b973-4c6c-a5e0-89183ba99ff3",
      "risk_severity": "string",
      "risk_total": "string",
      "rule_id": "string",
      "scanner_severity": "string",
      "severity_source": "cvss",
      "sla_due_at": "2019-08-24T14:15:22Z",
      "source_family": "scanner",
      "source_tools": [
        {
          "rule_id": "string",
          "tool": "string",
          "version": "string"
        }
      ],
      "state": "new",
      "title": "string",
      "tool": "string"
    }
  ],
  "next_cursor": "string"
}
{
  "code": "validation_failed",
  "detail": "The request body did not match the documented schema.",
  "instance": "/v1/audits",
  "request_id": "018f6f5d-36a2-7a2d-a8f6-ec1a55c03e45",
  "status": 422,
  "title": "Validation Failed",
  "type": "https://api.veriom.ai/problems/validation_failed"
}
{
  "code": "validation_failed",
  "detail": "The request body did not match the documented schema.",
  "instance": "/v1/audits",
  "request_id": "018f6f5d-36a2-7a2d-a8f6-ec1a55c03e45",
  "status": 422,
  "title": "Validation Failed",
  "type": "https://api.veriom.ai/problems/validation_failed"
}
{
  "code": "validation_failed",
  "detail": "The request body did not match the documented schema.",
  "instance": "/v1/audits",
  "request_id": "018f6f5d-36a2-7a2d-a8f6-ec1a55c03e45",
  "status": 422,
  "title": "Validation Failed",
  "type": "https://api.veriom.ai/problems/validation_failed"
}
{
  "code": "validation_failed",
  "detail": "The request body did not match the documented schema.",
  "instance": "/v1/audits",
  "request_id": "018f6f5d-36a2-7a2d-a8f6-ec1a55c03e45",
  "status": 422,
  "title": "Validation Failed",
  "type": "https://api.veriom.ai/problems/validation_failed"
}
{
  "code": "validation_failed",
  "detail": "The request body did not match the documented schema.",
  "instance": "/v1/audits",
  "request_id": "018f6f5d-36a2-7a2d-a8f6-ec1a55c03e45",
  "status": 422,
  "title": "Validation Failed",
  "type": "https://api.veriom.ai/problems/validation_failed"
}
{
  "code": "validation_failed",
  "detail": "The request body did not match the documented schema.",
  "instance": "/v1/audits",
  "request_id": "018f6f5d-36a2-7a2d-a8f6-ec1a55c03e45",
  "status": 422,
  "title": "Validation Failed",
  "type": "https://api.veriom.ai/problems/validation_failed"
}
{
  "code": "validation_failed",
  "detail": "The request body did not match the documented schema.",
  "instance": "/v1/audits",
  "request_id": "018f6f5d-36a2-7a2d-a8f6-ec1a55c03e45",
  "status": 422,
  "title": "Validation Failed",
  "type": "https://api.veriom.ai/problems/validation_failed"
}