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

# List recognized confirmed Polygon settlements

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

## Request

- Base URL: `https://api.aifinpay.io`
- URL: `https://api.aifinpay.io/api/me/merchants/{id}/settlements`
- 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
- `limit` integer
- `cursor` string

## Response `200`

Page plus aggregate over ALL filtered snapshot rows before pagination.

- SettlementFeed
  - `scope` 'site' | 'wallet' | 'account_wallet', required
  - `rows` SettlementRow[], required
    - `event_id` string, required
    - `chain` 'polygon', required
    - `network_mode` 'live', required
    - `tx_ref` string, required
    - `log_index` integer, required
    - `block_number` string, required
    - `block_ts` string, date-time, required
    - `payer` string, required
    - `payout_address` string, required
    - `asset` object, required
      - `address` string, required
      - `symbol` string, nullable, required
      - `decimals` integer, nullable, required
    - `amounts` object, required
      - `gross_base_units` string, required
      - `merchant_base_units` string, required
      - `treasury_base_units` string, required
      - `creator_base_units` string, required
    - `gross_usd_micros` string, nullable, required
    - `attribution` object, required
      - `state` 'assigned' | 'unknown', required
      - `merchant_id` string
      - `merchant_name` string
      - `resource` string
    - `receipt` object, required
      - `state` 'linked' | 'unknown', required
      - `receipt_id` string
    - `provenance` 'indexer' | 'legacy_receipt' | 'legacy_unresolved', required
  - `page` object, required
    - `next_cursor` string, nullable, required
    - `as_of` string, date-time, required
  - `summary` 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
  - `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

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