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
}

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.