> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get tenant outcome statistics

> Per-SKU rollups for the authenticated tenant over a time window. Powers the Appendix D.5 5% Dispute-Rate alarm and the Appendix D.6 quarterly review…

Per-SKU rollups for the authenticated tenant over a time window.

Powers the Appendix D.5 5% Dispute-Rate alarm and the Appendix D.6
quarterly review. Window defaults: last 30 days ending now.

### Query parameters

<ParamField query="window_start" type="string (date-time),null" />

<ParamField query="window_end" type="string (date-time),null" />

### Response

`OutcomeStatsResponse`

<ResponseField name="window_start" type="string (date-time)" required />

<ResponseField name="window_end" type="string (date-time)" required />

<ResponseField name="by_sku" type="OutcomeStatsBySKU[]" required>
  <Expandable title="OutcomeStatsBySKU">
    <ResponseField name="type" type="string" required />

    <ResponseField name="total" type="integer" required />

    <ResponseField name="completed" type="integer" required />

    <ResponseField name="disputed" type="integer" required />

    <ResponseField name="confirmed_errors" type="integer" required />

    <ResponseField name="dispute_rate" type="number" required />

    <ResponseField name="total_billable_usd" type="string" required />
  </Expandable>
</ResponseField>

<ResponseField name="overall_dispute_rate" type="number" required />

### Status codes

| Code  | Meaning             |
| ----- | ------------------- |
| `200` | Successful Response |
| `422` | Validation Error    |

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://api.computer.stateset.app/api/v1/outcomes/stats' \
    --header 'X-API-Key: YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "window_start": "2026-08-31T14:22:05Z",
    "window_end": "2026-08-31T14:22:05Z",
    "by_sku": [
      {
        "type": "resolved_contact",
        "total": 102,
        "completed": 1,
        "disputed": 1,
        "confirmed_errors": 1,
        "dispute_rate": 7.5,
        "total_billable_usd": "string"
      }
    ],
    "overall_dispute_rate": 7.5
  }
  ```
</ResponseExample>