> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hitpayapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Invoices

> List all invoices with status and date filtering



## OpenAPI

````yaml get /v1/invoices
openapi: 3.1.1
info:
  title: HitPay API
  description: >-
    Accept PayNow, FPX, QRIS, GrabPay, cards, and 40+ payment methods with a
    single API. Production base URL: https://api.hit-pay.com, Sandbox:
    https://api.sandbox.hit-pay.com
  version: '1.0'
servers:
  - url: https://api.hit-pay.com
    description: Production
  - url: https://api.sandbox.hit-pay.com
    description: Sandbox
security: []
paths:
  /v1/invoices:
    get:
      summary: Get all invoice
      description: Get the invoice and filter
      operationId: get-invoices
      parameters:
        - name: X-BUSINESS-API-KEY
          in: header
          required: true
          style: simple
          explode: false
          schema:
            type: string
            example: b286daabf9921b5a01a4621f026c111e046f8911feba212996c92159b98427d
        - name: customer_email
          in: query
          schema:
            type: string
        - name: status
          in: query
          description: Invoice status, options [draft, sent, pending, overdue, paid]
          schema:
            type: string
        - name: reference
          in: query
          schema:
            type: string
        - name: per_page
          in: query
          description: >-
            Number of invoices per page. Must be one of 5, 10, 20, 25, 50, 100
            or 1000.
          schema:
            type: integer
            enum:
              - 5
              - 10
              - 20
              - 25
              - 50
              - 100
              - 1000
            default: 25
        - name: cursor
          in: query
          description: >-
            This endpoint uses cursor pagination, not page numbers (a `page`
            parameter is ignored). Leave `cursor` empty for the first page. For
            the next page, pass the `meta.next_cursor` value from the previous
            response (or follow `links.next`). Keep the same `per_page` and
            filters, and stop when `meta.next_cursor` is `null`.
          schema:
            type: string
      responses:
        '200':
          description: '200'
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    description: Invoices on this page.
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        invoice_number:
                          type: string
                        reference:
                          type: string
                        email:
                          type: string
                        currency:
                          type: string
                        amount:
                          type: number
                        invoice_date:
                          type: string
                        due_date:
                          type: string
                        invoice_link:
                          type: string
                        created_at:
                          type: string
                        updated_at:
                          type: string
                  links:
                    type: object
                    properties:
                      first: {}
                      last: {}
                      prev:
                        type:
                          - string
                          - 'null'
                      next:
                        type:
                          - string
                          - 'null'
                        description: URL of the next page, or null on the last page.
                  meta:
                    type: object
                    properties:
                      path:
                        type: string
                      per_page:
                        type: integer
                      next_cursor:
                        type:
                          - string
                          - 'null'
                        description: >-
                          Pass this as `cursor` to get the next page. `null`
                          when there are no more invoices.
                      prev_cursor:
                        type:
                          - string
                          - 'null'
        '404':
          description: '404'
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                type: object
                properties: {}
      deprecated: false

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.