---
title: "Get settlement by date and cycle"
method: GET
path: "/settlements/{date}/{cycle}"
tags: ["Settlements"]
---

# Get settlement by date and cycle

`GET /settlements/{date}/{cycle}`

## Request

- Base URL: `https://api.palomma.com/v1`
- URL: `https://api.palomma.com/v1/settlements/{date}/{cycle}`
- Auth: HTTP bearer

Retrieves a single settlement by date and cycle.

## Path parameters

- `date` string, date, required
- `cycle` string, required

## Response `200`

Settlement found

- Settlement
  - `date` string, required: Settlement date (`YYYY-MM-DD`).
  - `cycle` string, required: Settlement cycle identifier.
  - `status` 'processing' | 'paid' | 'credited' | 'error', required: Settlement status: `processing`, `paid`, `credited`, or `error`.
  - `numberOfInvoices` number, required: Total number of invoices included in this settlement.
  - `amountCollected` number, required: Gross amount collected in COP.
  - `fees` number, required: Total fees deducted in COP.
  - `feesPostpaid` boolean, required: Whether fees are billed separately (postpaid) for this settlement.
  - `adjustments` number, required: Any adjustments applied to the settlement amount in COP.
  - `gateway` boolean, required: Whether this is a gateway settlement.
  - `paymentAmount` number, required: Net amount paid out in COP.

## Other responses

- `400`: Invalid request input
- `401`: Invalid or missing bearer token
- `404`: Resource not found
- `500`: Unexpected server error

---

[API](https://skmtc.dev/palomma/apis/palomma-rentals-api.md) - [All operations](https://skmtc.dev/palomma/apis/palomma-rentals-api/llms.txt) - [OpenAPI document](https://skmtc.dev/palomma/apis/palomma-rentals-api/revisions/1ccb5e11c48d?raw)