Saltar al contenido principal
GET
/
invoices
Listar facturas
curl --request GET \
  --url https://api.palomma.com/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.