---
title: "Settlements"
description: "A **Settlement** is a periodic accounting record that summarizes payments, refunds, and fees for a given settlement period."
url: "https://docs.komoju.com/en/api-reference#2024-07-15/tag/settlements"
source_url: "https://docs.komoju.com/en/api-reference/2024-07-15/resources/settlements.md"
language: en
api_version: "2024-07-15"
---

# Settlements

A **Settlement** is a periodic accounting record that summarizes payments, refunds, and fees for a given settlement period. Settlements are what KOMOJU uses to compute the amount of a Disbursement, and provide the line-level detail your finance team needs for reconciliation.

## The Settlement object

A **Settlement** is a periodic accounting record summarizing payments,
refunds, and fees for a given settlement period. Settlements are what
KOMOJU uses to compute the amount of a `Disbursement`, and provide the
line-level detail your finance team needs for reconciliation.

### Attributes

- **`id`** *string (UUID)* *required*

  A unique 25-character alphanumeric resource identifier.

- **`resource`** *string enum* *required*

  Resource type name, always "settlement".

- **`reference`** *string* *required*

  Human-readable reference code for this settlement.

- **`merchant_name`** *string* *required*

  Name of the merchant associated with this settlement.

- **`company_name`** *string or null* *required*

  Legal company name of the merchant, or null if not set.

- **`cycle`** *string* *required*

  Settlement cycle identifier (e.g. the week or month period covered).

- **`status`** *string* *required*

  Current status of this settlement.

- **`amount`** *string* *required*

  Total settlement amount as a formatted string.

- **`currency`** *string* *required*

  Currency of this settlement.

- **`cutoff_time`** *string* *required*

  Cutoff timestamp for transactions included in this settlement.

- **`created_at`** *string* *required*

  Timestamp when this settlement record was created.

- **`download`** *object* *required*

### Example

```json
{
  "id": "string",
  "resource": "settlement",
  "reference": "STLM-2025-01",
  "merchant_name": "Acme Inc.",
  "company_name": "string",
  "cycle": "string",
  "status": "string",
  "amount": "string",
  "currency": "string",
  "cutoff_time": "2024-01-01T00:00:00Z",
  "created_at": "2024-01-01T00:00:00Z",
  "download": {
    "csv": "string",
    "xls": "string"
  }
}
```

## Endpoints

### Balance: Show

- [GET /balances/{currency}](https://docs.komoju.com/en/api-reference/2024-07-15/show-balance.md)

### Balance: Transactions

- [GET /balances/{currency}/transactions](https://docs.komoju.com/en/api-reference/2024-07-15/balance-transactions.md)

### Balance: Transaction

- [GET /balances/{currency}/transactions/{transaction_uuid}](https://docs.komoju.com/en/api-reference/2024-07-15/show-transaction.md)

### Settlement: Index

- [GET /settlements](https://docs.komoju.com/en/api-reference/2024-07-15/list-settlements.md)

### Settlement: Show

- [GET /settlements/{id}](https://docs.komoju.com/en/api-reference/2024-07-15/show-settlement.md)

### Settlement: CSV

- [GET /settlements/{id}/csv](https://docs.komoju.com/en/api-reference/2024-07-15/show-settlement-csv.md)

### Settlement: XLS

- [GET /settlements/{id}/xls](https://docs.komoju.com/en/api-reference/2024-07-15/show-settlement-xls.md)

### Settlement: PDF

- [GET /settlements/{id}/pdf](https://docs.komoju.com/en/api-reference/2024-07-15/show-settlement-pdf.md)