---
title: "Read the signed findings of an assessment"
method: GET
path: "/v1/assessments/{assessmentId}/findings"
---

# Read the signed findings of an assessment

`GET /v1/assessments/{assessmentId}/findings`

## Request

- Base URL: `https://api.decionis.com`
- URL: `https://api.decionis.com/v1/assessments/{assessmentId}/findings`
- Auth: HTTP bearer

Organization API key with decision:read. Returns every findings artifact signed for the assessment in this organization, each verifiable offline.

## Response `200`

Signed findings artifacts for the assessment.

- object
  - `version` 'decionis.assessments.findings/1', required
  - `assessment_id` string, uuid, required
  - `items` SignedAssessmentFindings[], required
    - `artifact` object, required
      - `assessment_id` string, uuid, required
      - `platform` string, required
      - `evaluator` object, required
        - `platform` string, required
        - `methodology` string, required
      - `source` object, required
        - `kind` 'connected_history' | 'recorded_evidence', required
        - `connection_id` string, uuid, nullable, required
        - `company_id` string, nullable, required
        - `revision` string, required
        - `as_of` string, date-time, required
        - `window` object, required
          - `from` string, date-time, required
          - `to` string, date-time, required
      - `status` 'complete' | 'partial', required
      - `coverage` object, required
        - `assessed` integer, required
        - `total` integer, nullable, required
        - `limit` integer, required
        - `truncated` boolean, required
        - `complete` boolean, required
        - `reasons` string[], required
        - `gaps` object[], required
          - `code` string, required
          - `finding_types` string[], required
      - `findings` object[], required
        - `finding_id` string, required
        - `type` string, required
        - `check_id` 'P01' | 'P02' | 'P03' | 'P04' | 'P05' | 'P06' | 'P07' | 'P08' | 'P09' | 'P10' | 'P11' | 'P12' | 'P13' | 'P14' | 'P15' | 'P16', required
        - `record_digest` string, required
        - `occurred_at` string, date-time, required
        - `amount` object, required
          - `currency` string, required
          - `scale` integer, required
          - `amount_minor` integer, required
        - `measurements` object, required
        - `basis` 'source_record' | 'recorded_observation', required
      - `records` object[], required
        - `record_digest` string, required
        - `occurred_at` string, date-time, required
        - `amount` object, nullable, required
          - `currency` string, required
          - `scale` integer, required
          - `amount_minor` integer, required
        - `replay` object, nullable, required
          - `action` union, required
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
          - `facts` CommercePreflightFacts, required
            - `observed_at` string, date-time
            - `source` string
            - `currency` string
            - `pricing` object
              - …
            - `cost_basis` object
              - …
            - `inventory` object
              - …
            - `region` object
              - …
            - `discounts` object
              - …
            - `contract` object
              - …
            - `promotion` object
              - …
            - `refund` object
              - …
            - `lifecycle` object
              - …
            - `payment` object
              - …
            - `beneficiary` object
              - …
            - `treasury` object
              - …
      - `version` 'decionis.assessments.findings/1', required
      - `findings_id` string, uuid, required
      - `org_id` string, uuid, required
      - `submitted_at` string, date-time, required
      - `submission_sha256` string, required
      - `totals` object[], required
        - `type` string, required
        - `check_id` 'P01' | 'P02' | 'P03' | 'P04' | 'P05' | 'P06' | 'P07' | 'P08' | 'P09' | 'P10' | 'P11' | 'P12' | 'P13' | 'P14' | 'P15' | 'P16', required
        - `currency` string, required
        - `scale` integer, required
        - `amount_minor` integer, required
        - `count` integer, required
    - `artifact_sha256` string, required
    - `canonicalization` 'RFC8785/JCS', required
    - `verification` 'signed' | 'unsigned', required
    - `signature` object, nullable, required
      - `algorithm` 'Ed25519', required
      - `keyId` string, required
      - `value` string, required
    - `public_jwks_path` '/.well-known/decision-dossier-jwks.json', required

## Other responses

- `403`: Structured API error

---

[API](https://skmtc.dev/decionis/apis/decionis-policy-evaluation-api.md) · [All operations](https://skmtc.dev/decionis/apis/decionis-policy-evaluation-api/llms.txt) · [OpenAPI document](https://skmtc.dev/decionis/apis/decionis-policy-evaluation-api/revisions/357f5e459d0c?raw)