> ## 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.

# Lists deductions for the tenant with an exposure/recovery summary.

> Deductions + summary

### Response

`Deduction[]` — each element:

<ResponseField name="adjustment_number" type="string" required>
  The 812 adjustment / chargeback number.
</ResponseField>

<ResponseField name="amount" type="string" required />

<ResponseField name="category" type="string">
  Operator-assigned root-cause category (e.g. `shortage`, `label`, `asn`).
</ResponseField>

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

<ResponseField name="currency" type="string" />

<ResponseField name="evidence" type="EvidenceNote[]">
  Supporting evidence attached for the dispute.

  <Expandable title="EvidenceNote">
    <ResponseField name="actor" type="string" required />

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

    <ResponseField name="note" type="string" required />

    <ResponseField name="url" type="string">
      Link to the supporting artifact (an evidence-bundle export, a POD scan).
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="history" type="DeductionEvent[]" required>
  <Expandable title="DeductionEvent">
    <ResponseField name="action" type="string" required />

    <ResponseField name="actor" type="string" required />

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

    <ResponseField name="note" type="string" />
  </Expandable>
</ResponseField>

<ResponseField name="id" type="string" required />

<ResponseField name="invoice_number" type="string" />

<ResponseField name="partner_id" type="string" required />

<ResponseField name="reason_codes" type="string[]" />

<ResponseField name="recovered_amount" type="string">
  Amount recovered when disputed successfully (≤ `amount`).
</ResponseField>

<ResponseField name="status" type="DeductionStatus" required />

<ResponseField name="tenant_id" type="string" required />

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

### Status codes

| Code  | Meaning                   |
| ----- | ------------------------- |
| `200` | Deductions + summary      |
| `403` | Admin credential required |

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://edi.stateset.com/v1/deductions' \
    --header 'Authorization: Bearer YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "adjustment_number": "string",
      "amount": "string",
      "category": "string",
      "created_at": "2026-07-24T12:00:00Z",
      "currency": "string",
      "evidence": [
        {
          "actor": null,
          "at": null,
          "note": null,
          "url": null
        }
      ],
      "history": [
        {
          "action": null,
          "actor": null,
          "at": null,
          "note": null
        }
      ],
      "id": "string",
      "invoice_number": "string",
      "partner_id": "string",
      "reason_codes": [
        "string"
      ],
      "recovered_amount": "string",
      "status": "open",
      "tenant_id": "string",
      "updated_at": "2026-07-24T12:00:00Z"
    }
  ]
  ```
</ResponseExample>