---
title: "Summarize recognized confirmed Polygon settlements"
method: GET
path: "/api/me/merchants/{id}/settlements/summary"
tags: ["me_merchants"]
---

# Summarize recognized confirmed Polygon settlements

`GET /api/me/merchants/{id}/settlements/summary`

## Request

- Base URL: `https://api.aifinpay.io`
- URL: `https://api.aifinpay.io/api/me/merchants/{id}/settlements/summary`
- Auth: API key in cookie `aifinpay_session`

Authenticated immutable financial facts, independently of retained access receipts. Historical coverage is qualified, never certified lifetime. Exact base units and historically proven quoted gross USD; no current FX. Wallet scope uses only server-derived current and proven historical payouts, disclosing public facts for unknown site associations. No payment or receipt is created.

## Path parameters

- `id` string, required

## Query parameters

- `scope` 'site' | 'wallet'
- `from` string, date-time
- `to` string, date-time
- `chain` 'polygon'
- `asset` string
- `search` string

## Response `200`

UTC financial windows over all filtered snapshot rows.

- SettlementWindows
  - `scope` 'site' | 'wallet' | 'account_wallet', required
  - `as_of` string, date-time, required
  - `timezone` 'UTC', required
  - `coverage` SettlementCoverage, required
    - `ledger` 'partial' | 'current' | 'degraded', required
    - `sources` object[], required
      - `source` string, required
      - `from_block` string, nullable, required
      - `through_block` string, nullable, required
      - `as_of` string, date-time, nullable, required
      - `status` 'partial' | 'current' | 'degraded', required
    - `receipt` 'available' | 'partial' | 'unavailable', required
    - `history_complete` false, required
    - `unsupported_chains` string[], required
  - `windows` object, required
    - `today` SettlementSummary, required
      - `count` integer, required
      - `assets` object[], required
        - `chain` 'polygon', required
        - `token_address` string, required
        - `symbol` string, nullable, required
        - `decimals` integer, nullable, required
        - `gross_base_units` string, required
        - `merchant_base_units` string, required
        - `treasury_base_units` string, required
        - `creator_base_units` string, required
      - `known_gross_usd_micros` string, nullable, required
      - `valued_count` integer, required
      - `unknown_valuation_count` integer, required
    - `yesterday` SettlementSummary, required
      - `count` integer, required
      - `assets` object[], required
        - `chain` 'polygon', required
        - `token_address` string, required
        - `symbol` string, nullable, required
        - `decimals` integer, nullable, required
        - `gross_base_units` string, required
        - `merchant_base_units` string, required
        - `treasury_base_units` string, required
        - `creator_base_units` string, required
      - `known_gross_usd_micros` string, nullable, required
      - `valued_count` integer, required
      - `unknown_valuation_count` integer, required
    - `this_month` SettlementSummary, required
      - `count` integer, required
      - `assets` object[], required
        - `chain` 'polygon', required
        - `token_address` string, required
        - `symbol` string, nullable, required
        - `decimals` integer, nullable, required
        - `gross_base_units` string, required
        - `merchant_base_units` string, required
        - `treasury_base_units` string, required
        - `creator_base_units` string, required
      - `known_gross_usd_micros` string, nullable, required
      - `valued_count` integer, required
      - `unknown_valuation_count` integer, required
    - `d7` SettlementSummary, required
      - `count` integer, required
      - `assets` object[], required
        - `chain` 'polygon', required
        - `token_address` string, required
        - `symbol` string, nullable, required
        - `decimals` integer, nullable, required
        - `gross_base_units` string, required
        - `merchant_base_units` string, required
        - `treasury_base_units` string, required
        - `creator_base_units` string, required
      - `known_gross_usd_micros` string, nullable, required
      - `valued_count` integer, required
      - `unknown_valuation_count` integer, required
    - `d30` SettlementSummary, required
      - `count` integer, required
      - `assets` object[], required
        - `chain` 'polygon', required
        - `token_address` string, required
        - `symbol` string, nullable, required
        - `decimals` integer, nullable, required
        - `gross_base_units` string, required
        - `merchant_base_units` string, required
        - `treasury_base_units` string, required
        - `creator_base_units` string, required
      - `known_gross_usd_micros` string, nullable, required
      - `valued_count` integer, required
      - `unknown_valuation_count` integer, required
    - `observed` SettlementSummary, required
      - `count` integer, required
      - `assets` object[], required
        - `chain` 'polygon', required
        - `token_address` string, required
        - `symbol` string, nullable, required
        - `decimals` integer, nullable, required
        - `gross_base_units` string, required
        - `merchant_base_units` string, required
        - `treasury_base_units` string, required
        - `creator_base_units` string, required
      - `known_gross_usd_micros` string, nullable, required
      - `valued_count` integer, required
      - `unknown_valuation_count` integer, required

## Other responses

- `400`: Malformed or unsupported filter/cursor/scope; arbitrary wallet input is rejected.
- `401`: Authentication required.
- `404`: Merchant is absent or not currently owned; no existence disclosure.
- `503`: Required accounting or ownership storage unavailable. Cache-Control: no-store; error=settlement_accounting_unavailable.

---

[API](https://skmtc.dev/aifinpay/apis/aifinpay-api.md) · [All operations](https://skmtc.dev/aifinpay/apis/aifinpay-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aifinpay/apis/aifinpay-api/revisions/a9a644bb441d?raw)