Saltar al contenido principal
GET
/
invoices
Listar facturas
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 }

Autorizaciones

​
Authorization
string
header
requerido

Enviar header: Authorization: Bearer <apiKey>.

Parámetros de consulta

​
reference
string

Filtrar por referencia de factura.

​
customerDocumentNumber
string

Filtrar por numero de documento del cliente.

​
contract
string

Filtrar por identificador de contrato.

​
paymentDate
string<date>

Filtrar por fecha exacta de pago.

​
settlementDate
string<date>

Filtrar por fecha de liquidacion.

​
settlementCycle
string

Filtrar por ciclo de liquidacion.

​
limit
integer
predeterminado:20

Cantidad de resultados por pagina. Min 1, max 100.

Rango requerido: 1 <= x <= 100
​
cursor
string

Cursor opaco de una respuesta anterior para obtener la siguiente pagina.

Respuesta

Lista paginada de facturas

​
items
object[]
requerido

Facturas en la pagina actual.

​
count
integer
requerido

Cantidad de facturas retornadas en esta pagina.

​
cursor
string | null

Cursor para la siguiente pagina. null cuando no hay mas paginas.