Skip to main content

List all Invoices

GET 
/v1/invoices

Lista las renovaciones de la cuenta. The renovaciones representan cada período de cobro de un subscription. ONVO crea una renovación al inicio de la suscripción y en cada renovación exitosa. Cada renovación está associated a una payment intent y permite consultar el cobro que corresponde a ese período.

Ejemplos de URLs:

  • Paginación: GET /v1/invoices?limit=25&startingAfter=cl40muorw00493ndp0okzk2g3
  • Filtrar por customer y status: GET /v1/invoices?customerId=cl40muorw00493ndp0okzk2g3&status=paid
  • Filtrar por varios statuss: GET /v1/invoices?status=open,paid
  • Filtrar por rango de fechas: GET /v1/invoices?createdAt[gte]=2026-01-01T00:00:00.000Z&createdAt[lte]=2026-01-31T23:59:59.999Z
  • Filtrar por rango de amounts: GET /v1/invoices?total[gte]=1000&total[lte]=5000
  • Filtrar por metadata: GET /v1/invoices?metadata[key]=orderId&metadata[value]=order_123
  • Expandir objects relacionados: GET /v1/invoices?expand=payment_intent&expand=subscription

Si construís la URL manualmente, podés escribir filtros con corchetes como createdAt[gte] y metadata[key]. The customers HTTP suelen codificarlos como createdAt%5Bgte%5D y metadata%5Bkey%5D al enviar la solicitud.

Request​

Responses​

OK