---
title: "List configured v1.3 settlement routes"
method: GET
path: "/v1/settlement/routes"
tags: ["settlement"]
---

# List configured v1.3 settlement routes

`GET /v1/settlement/routes`

## Request

- Base URL: `https://api.aifinpay.io`
- URL: `https://api.aifinpay.io/v1/settlement/routes`
- Auth: none required

Read-only registry discovery. Disabled routes remain visible with live=false and disabled_reason. Callers must independently verify the route before signing.

## Query parameters

- `route_class` 'AIFP-1' | 'AIFP-2'

## Response `200`

Configured routes; no settlement is enabled by this request.

- object
  - `routes` object[], required
    - `route_class` 'AIFP-1' | 'AIFP-2', required
    - `profile` object, required
      - `route_class` 'AIFP-1' | 'AIFP-2', required
      - `settlement_semantics` 'gross-inclusive', required
      - `treasury_bps` integer, required
      - `creator_bps` integer, required
      - `fee_on_top` false, required
      - `required_splitter_version` '1.3', required
    - `network` string, required
    - `chain_id` integer, required
    - `testnet` boolean, required: True only for a canonical test network. Testnet settlement additionally requires explicit server dev mode.
    - `name` string, required
    - `native_asset` string, required
    - `stable_assets` object, required
    - `explorer` string, uri, required
    - `live` boolean, required: Configured availability, including the registry flag, supersession and validity window. Not an RPC health or deployment attestation.
    - `splitter` string, required
    - `splitter_version` '1.3', required
    - `runtime_code_hash` string, required
    - `disabled_reason` string: Present when live is false.

## Other responses

- `400`: AIFP-* error envelope. See backend/server.js safe error handler.
- `401`: AIFP-* error envelope. See backend/server.js safe error handler.
- `403`: AIFP-* error envelope. See backend/server.js safe error handler.
- `404`: AIFP-* error envelope. See backend/server.js safe error handler.
- `429`: AIFP-* error envelope. See backend/server.js safe error handler.
- `5XX`: AIFP-* error envelope. See backend/server.js safe error handler.

---

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