---
title: "Read the outcome fee charged for a statement"
method: GET
path: "/v1/outcomes/statements/{statementId}/charge"
---

# Read the outcome fee charged for a statement

`GET /v1/outcomes/statements/{statementId}/charge`

## Request

- Base URL: `https://api.decionis.com`
- URL: `https://api.decionis.com/v1/outcomes/statements/{statementId}/charge`
- Auth: HTTP bearer

Organization API key with decision:read and role VIEWER or higher. The signed monthly fee (decionis.outcomes.charge/1) Decionis computed from this statement and the agreement's commercial terms (a share of the net benefit or a fee on governed value, raised to the floor and limited by the cap), with the marketplace receipt once it was billed. 404 when the agreement charges nothing, the agreement is a sandbox, or the statement is unsigned.

## Response `200`

The charge and its receipt (null until billed).

- object
  - `charge` SignedOutcomeCharge, required
    - `artifact` object, required
      - `version` 'decionis.outcomes.charge/1', required
      - `charge_id` string, uuid, required
      - `statement_id` string, uuid, required
      - `statement_sha256` string, required
      - `agreement_id` string, uuid, required
      - `agreement_sha256` string, required
      - `org_id` string, uuid, required
      - `period` string, required
      - `basis` 'NET_BENEFIT_SHARE' | 'GOVERNED_VALUE_FEE', required
      - `currency` string, required
      - `scale` integer, required
      - `carried_in_minor` integer, required
      - `base_minor` integer, required
      - `rate_bps` integer, required
      - `computed_minor` integer, required
      - `floor_minor` integer, required
      - `cap_minor` integer, nullable, required
      - `amount_minor` integer, required
      - `above_floor_minor` integer, required
      - `carried_out_minor` integer, required
      - `disputed` integer, required
      - `issued_at` string, date-time, required
    - `artifact_sha256` string, required
    - `canonicalization` 'RFC8785/JCS', required
    - `signature` object, required
      - `algorithm` 'Ed25519', required
      - `keyId` string, required
      - `value` string, required
    - `public_jwks_path` '/.well-known/decision-dossier-jwks.json', required
  - `receipt` OutcomeChargeReceipt, required
    - `version` 'decionis.outcomes.receipt/1', required
    - `platform` 'microsoft' | 'aws', required
    - `subscription_id` string, required
    - `plan_id` string, required
    - `dimension` string, required
    - `quantity` number, required
    - `unit_minor` integer, required
    - `status` 'ACCEPTED' | 'DUPLICATE' | 'NOTHING_TO_BILL', required
    - `usage_reference` string, nullable, required
    - `reported_at` string, date-time, required

## Other responses

- `403`: Structured API error
- `404`: Structured API error
- `503`: 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)
