Skip to main content
GET
/
settlements
/
{date}
/
{cycle}
Get settlement by date and cycle
curl --request GET \
  --url https://api.palomma.com/v1/settlements/{date}/{cycle} \
  --header 'Authorization: Bearer <token>'
{
  "date": "2026-03-12",
  "cycle": "1",
  "status": "paid",
  "numberOfInvoices": 24,
  "amountCollected": 45200000,
  "fees": 610000,
  "feesPostpaid": false,
  "adjustments": 0,
  "gateway": false,
  "paymentAmount": 44590000
}

Authorizations

​
Authorization
string
header
required

Send header: Authorization: Bearer <apiKey>.

Path Parameters

​
date
string<date>
required

Settlement date in YYYY-MM-DD format.

​
cycle
string
required

Settlement cycle identifier.

Response

Settlement found

​
date
string
required

Settlement date (YYYY-MM-DD).

​
cycle
string
required

Settlement cycle identifier.

​
status
enum<string>
required

Settlement status: processing, paid, credited, or error.

Available options:
processing,
paid,
credited,
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.