Outcomes

List an organization's outcome charges (internal producers)

GET
/v1/outcomes/charges

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.

Authorization

ApiKeyAuth
AuthorizationBearer <token>

An organization API key. Its scopes decide what it may call; decision:shadow is the narrowest: SHADOW evaluations through POST /v1/authority/grants or its alias POST /v1/authority/enforce-and-bind only (DECISION_SHADOW_MODE_DENIED in any other mode; DECISION_SHADOW_FIELD_DENIED for a body carrying context.decionis_policy, evidence or escalation), with no integration dispatch. A key whose only scope is decision:shadow (an AgentSafe hosted gateway's) reaches exactly those two, POST /v1/auth/credential-context, POST /v1/hosted-gateway/keys/confirm and POST /v1/hosted-gateway/keys/revoke-self; every other route answers 403 HOSTED_GATEWAY_KEY_PATH_DENIED. decision:enforce is an enforced hosted gateway's key: evaluations in SHADOW or ENFORCEMENT through POST /v1/authority/grants or its alias (400 DECISION_ENFORCE_FIELD_DENIED for a body carrying context.decionis_policy; it never holds policy:write), and the grants and managed escalations they bind. A key whose scopes are decision:enforce (with or without decision:shadow) reaches exactly POST /v1/authority/enforce-and-bind, POST /v1/authority/grants, GET /v1/authority/grants/{grant_id}, POST /v1/authority/grants/{grant_id}/claims, POST /v1/authority/grants/{grant_id}/receipts, POST /v1/authority/grants/{grant_id}/reconciliations, POST /v1/execution/verify-token, POST /v1/execution/claim-token, POST /v1/execution/consume-token, POST /v1/execution/finalize-token, GET /v1/authority/escalations/{escalation_id}, DELETE /v1/authority/escalations/{escalation_id}, POST /v1/auth/credential-context, POST /v1/hosted-gateway/keys/confirm and POST /v1/hosted-gateway/keys/revoke-self, each id a UUID; every other route answers 403 HOSTED_GATEWAY_KEY_PATH_DENIED.

In: header

Query Parameters

org_id*string
Formatuuid
status?string
Default"unbilled"

Value in

  • "unbilled"
  • "all"

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/outcomes/charges?org_id=497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "charges": [    {      "charge": {        "artifact": {          "version": "decionis.outcomes.charge/1",          "charge_id": "cf8b747b-a752-4d0a-9a4d-7d19fc1769f3",          "statement_id": "6fcc7115-8e6b-40cd-9754-72e975d1d953",          "statement_sha256": "string",          "agreement_id": "67dd069b-637c-4b8e-8d92-17a313d06fb8",          "agreement_sha256": "string",          "org_id": "a40f5d1f-d889-42e9-94ea-b9b33585fc6b",          "period": "string",          "basis": "NET_BENEFIT_SHARE",          "currency": "string",          "scale": 0,          "carried_in_minor": 0,          "base_minor": 0,          "rate_bps": 0,          "computed_minor": 0,          "floor_minor": 0,          "cap_minor": 0,          "amount_minor": 0,          "above_floor_minor": 0,          "carried_out_minor": 0,          "disputed": 0,          "issued_at": "2019-08-24T14:15:22Z"        },        "artifact_sha256": "string",        "canonicalization": "RFC8785/JCS",        "signature": {          "algorithm": "Ed25519",          "keyId": "string",          "value": "string"        },        "public_jwks_path": "/.well-known/decision-dossier-jwks.json"      },      "receipt": {        "version": "decionis.outcomes.receipt/1",        "platform": "microsoft",        "subscription_id": "string",        "plan_id": "string",        "dimension": "string",        "quantity": 0,        "unit_minor": 1,        "status": "ACCEPTED",        "usage_reference": "string",        "reported_at": "2019-08-24T14:15:22Z"      }    }  ]}