v1

latestOpenAPI 3.1.02026-07-24233206489.1 KB

Invoices

List invoices

Lists the caller org's invoices. Without page it cursor-paginates (starting_after + has_more). With page it serves an offset page with total/page_count meta, plus sorting (order_by/order) and a query search; the sent and overdue statuses are read-time projections of open split by due date.

get/v1/invoices

Query parameters

Filter by status

customer_idstring

Filter by linked customer

starting_afterstring

Cursor: return results after this invoice ID

limitinteger

Cursor page size (default 10, max 100)

pageinteger

Offset mode: 1-based page number

per_pageinteger

Offset mode: page size (default 10, max 100)

order_bystring

Offset mode: sort column

order'asc' | 'desc'

Offset mode: sort direction

querystring

Offset mode: search over number / customer name / email

Response

has_moreboolean

Example response

{
  "data": [
    {
      "accent_color": "#0C2F28",
      "amount_due": 145000,
      "checkout_session_id": "cs_abc123",
      "created_at": "2026-07-08 08:00:00+00:00",
      "currency": "PHP",
      "customer_email": "juan@example.com",
      "customer_id": "cus_abc123",
      "customer_name": "Juan dela Cruz",
      "customer_phone": "+639171234567",
      "customer_tin": "123-456-789-000",
      "discount": 5000,
      "due_at": "2026-07-22 00:00:00+00:00",
      "footer_bg_color": "#FFFDF6",
      "footer_image_url": "https://example.com/footer.png",
      "header_bg_color": "#0C2F28",
      "header_image_url": "https://example.com/header.png",
      "hosted_slug": "inv-8f2k1x",
      "hosted_url": "https://invoices.paymongo.com/inv/inv-8f2k1x",
      "id": "si_abc123",
      "internal_notes": "Net-14 terms agreed with the client",
      "issue_at": "2026-07-08 00:00:00+00:00",
      "line_items": [
        {
          "amount": 75000,
          "description": "Website design services",
          "id": "sili_abc123",
          "line_total": 150000,
          "quantity": 2
        }
      ],
      "logo_url": "https://example.com/logo.png",
      "notes": "Thank you for your business!",
      "number": "INV-0001",
      "organization_id": "org_abc123",
      "paid_at": "2026-07-10 08:30:00+00:00",
      "payment_methods": [
        "card",
        "gcash"
      ],
      "reminders_enabled": true,
      "sent_at": "2026-07-08 09:00:00+00:00",
      "subtotal": 150000,
      "total": 145000,
      "updated_at": "2026-07-08 09:00:00+00:00"
    }
  ]
}