---
title: "List an organization's outcome charges (internal producers)"
method: GET
path: "/v1/outcomes/charges"
---

# List an organization's outcome charges (internal producers)

`GET /v1/outcomes/charges`

## Request

- Base URL: `https://api.decionis.com`
- URL: `https://api.decionis.com/v1/outcomes/charges`
- Auth: HTTP bearer

Internal. The producer that bills a platform subscription (Commerce) reads the charges of one organization with its producer token, which must carry the outcomes capability. status=unbilled (the default) returns only charges with no receipt. Contract: packages/shared/contracts/OutcomeCharge.v1.json.

## Query parameters

- `org_id` string, uuid, required
- `status` 'unbilled' | 'all'

## Response `200`

Charges, oldest month first, each with its receipt or null.

- object
  - `charges` object[], required
    - `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

- `400`: Structured API error
- `401`: Structured API error
- `403`: 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)