---
title: "Retrieve a list of split billing settlements"
method: GET
path: "/api/v1/split-billing/settlements"
tags: ["Split Billing"]
---

# Retrieve a list of split billing settlements

`GET /api/v1/split-billing/settlements`

Required scope: `split-billing:read`

## Query parameters

- `page` integer
- `perPage` integer
- `teamId` integer, nullable — Filter settlements by the team they belong to.
- `status` 'pending' | 'completed' | 'failed'
- `createdAtFrom` string, date-time, nullable — Return settlements created on or after this timestamp (ISO 8601, e.g. `2026-01-01T00:00:00Z`).
- `createdAtTo` string, date-time, nullable — Return settlements created on or before this timestamp (ISO 8601, e.g. `2026-03-31T23:59:59Z`).

## Response `200`

List of split billing settlements that match the criteria

- OffsetBasedResponse17
  - `data` SplitBillingSettlement[], required
    - `id` integer — Id of this settlement.
    - `teamId` integer — Id of the team this settlement belongs to.
    - `userId` integer — Id of the user that owns this settlement.
    - `amount` Money, required
      - `amount` integer, required — The amount of money
      - `currency` Currency, required
        - `id` integer, nullable — id of the currency
        - `master` boolean — Whether the currency is master or not, master meaning the default currency
        - `identifier` string, required — 3 characters identifier
        - `name` string — Name of the currency
        - `decimals` integer, required — How many decimals the currency has
      - `locale` string, required — Current user locale
    - `total` Money, required
      - `amount` integer, required — The amount of money
      - `currency` Currency, required
        - `id` integer, nullable — id of the currency
        - `master` boolean — Whether the currency is master or not, master meaning the default currency
        - `identifier` string, required — 3 characters identifier
        - `name` string — Name of the currency
        - `decimals` integer, required — How many decimals the currency has
      - `locale` string, required — Current user locale
    - `status` 'pending' | 'completed' | 'failed', required
    - `attempts` integer — Number of times the settlement has been attempted.
    - `lastAttemptAt` string, date-time, nullable — When the settlement was last attempted.
    - `period` string, nullable — Server-rendered (English) label for the billing period the settlement covers, e.g. `April 2026`. Prefer `firstItemAt`/`lastItemAt` for locale-aware rendering.
    - `firstItemAt` string, date-time, nullable — Timestamp of the earliest split-billing item in the settlement. Use together with `lastItemAt` to render a localised period. Null for historical settlements created before the field existed.
    - `lastItemAt` string, date-time, nullable — Timestamp of the latest split-billing item in the settlement. See `firstItemAt`.
    - `sessionCount` integer, nullable — Number of split-billing charges included in this settlement.
    - `createdAt` string, date-time, nullable — When this settlement was created.
  - `meta` MontaPageMeta, required
    - `itemCount` integer, required
    - `currentPage` integer, required
    - `perPage` integer, required
    - `totalPageCount` integer, required
    - `totalItemCount` integer, required

## Other responses

- `400` — The request is invalid
- `401` — Consumer with provided credentials was not found
- `403` — Operator doesn't have access to resource
- `404` — Entity with the provided id was not found

---

[API](https://skmtc.net/monta/apis/monta-partner-api.md) · [All operations](https://skmtc.net/monta/apis/monta-partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/monta/monta-partner-api/revisions/517e18f11015/schema)