Skip to main content
GET
/
invoices
List invoices
curl --request GET \
  --url https://api.palomma.com/v1/invoices \
  --header 'Authorization: Bearer <token>'
{ "items": [ { "id": "01HQY8EW1H9YGH5PAV5Y2M9R3T", "reference": "INV-2026-0001", "status": "paid", "amount": 1850000, "description": "Canon de arrendamiento marzo 2026", "contract": "CTR-8842", "customerDocumentNumber": "900123456", "createdAt": "2026-03-11T16:32:14.007Z", "paymentDate": "2026-03-11T18:01:03.219Z", "paymentMethod": "pse", "paymentSource": "link", "paymentAmount": 1850000, "settlementDate": "2026-03-12", "settlementTime": "1", "paymentId": "payin_8JkM2P", "paymentUrl": "https://pagos.palomma.com/pay/merchant_123/01HQY8EW1H9YGH5PAV5Y2M9R3T" } ], "cursor": "eyJwayI6InJlbnRhbHMj...", "count": 1 }

Documentation Index

Fetch the complete documentation index at: https://docs.palomma.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Send header: Authorization: Bearer <apiKey>.

Query Parameters

​
reference
string

Filter by invoice reference.

​
customerDocumentNumber
string

Filter by customer document number.

​
contract
string

Filter by contract identifier.

​
paymentDate
string<date>

Filter by exact payment date.

​
settlementDate
string<date>

Filter by settlement date.

​
settlementCycle
string

Filter by settlement cycle.

​
limit
integer
default:20

Number of results per page. Min 1, max 100.

Required range: 1 <= x <= 100
​
cursor
string

Opaque cursor from a previous response to fetch the next page.

Response

Paginated invoices list

​
items
object[]
required

Invoices in the current page.

​
count
integer
required

Number of invoices returned in this page.

​
cursor
string | null

Cursor for the next page. null when there are no more pages.