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

# Find Invoices (Advanced)

Returns a paginated list of invoices for the authenticated affiliate. Supports filtering by invoice status, date range, and balance thresholds. Results are sorted by date in descending order.

Pagination is controlled through the `page` and `page_size` **query parameters**, not the JSON request body. For example, `?page=2&page_size=100` returns the second page of 100 results.


## OpenAPI

````yaml openapi/affiliate-invoices.yaml post /affiliates/billings/affiliates/invoicestable
openapi: 3.0.3
info:
  title: Everflow Affiliate API - Invoices
  description: >
    Invoice endpoints for the Everflow Affiliate API. Affiliates can view their
    billing invoices, including line item details and payment history. For more
    detail, see [Processing Partner
    Invoices](https://helpdesk.everflow.io/customer/processing-partner-invoices)
    in the Help Center.
  version: 1.0.0
servers:
  - description: Production Server
    url: https://api.eflow.team/v1
security: []
tags:
  - name: Affiliate Invoices
    description: Endpoints for viewing affiliate invoices and billing details.
paths:
  /affiliates/billings/affiliates/invoicestable:
    post:
      tags:
        - Affiliate Invoices
      summary: Find Invoices (Advanced)
      parameters:
        - in: query
          name: page
          required: false
          schema:
            type: integer
            minimum: 1
            default: 1
          description: The page of results to retrieve.
        - in: query
          name: page_size
          required: false
          schema:
            type: integer
            minimum: 1
            default: 50
          description: The number of results to return per page.
      requestBody:
        required: true
        content:
          application/json:
            example:
              filters:
                affiliate_invoice_status: unpaid
              page: 1
              page_size: 50
            schema:
              type: object
              properties:
                filters:
                  type: object
                  description: Filter criteria for invoices.
                  properties:
                    affiliate_invoice_status:
                      type: string
                      enum:
                        - paid
                        - unpaid
                      description: Filter by invoice payment status.
                    min_start_time:
                      type: string
                      format: date-time
                      description: Minimum start date for the invoice period.
                    max_end_time:
                      type: string
                      format: date-time
                      description: Maximum end date for the invoice period.
                    min_balance:
                      type: number
                      description: Minimum invoice balance to include.
                    max_balance:
                      type: number
                      description: Maximum invoice balance to include.
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  invoices:
                    type: array
                    description: Array of invoices.
                    items:
                      $ref: '#/components/schemas/InvoiceTableItem'
                  paging:
                    type: object
                    properties:
                      page:
                        type: integer
                      page_size:
                        type: integer
                      total_count:
                        type: integer
      security:
        - API Key: []
components:
  schemas:
    InvoiceTableItem:
      type: object
      properties:
        network_affiliate_invoice_id:
          type: integer
          description: Unique identifier for the invoice.
        network_id:
          type: integer
          description: The network ID.
        affiliate_invoice_status:
          type: string
          description: Payment status of the invoice (paid, unpaid).
        start_time:
          type: string
          format: date-time
          description: Start of the billing period.
        end_time:
          type: string
          format: date-time
          description: End of the billing period.
        timezone_id:
          type: integer
          description: Timezone ID for the invoice period.
        balance:
          type: number
          description: Outstanding balance on the invoice.
        billed:
          type: number
          description: Total amount billed.
        paid:
          type: number
          description: Total amount paid.
        payment_terms:
          type: string
          description: Payment terms for the invoice (e.g. Net 30, Net 60).
        currency_id:
          type: string
          description: Currency code for the invoice (e.g. "USD").
        notes:
          type: string
          description: Notes on the invoice.
        time_created:
          type: integer
          example: 1734455015
          description: Unix timestamp of when the invoice was created.
        time_saved:
          type: integer
          example: 1734455015
          description: Unix timestamp of when the invoice was last saved.
  securitySchemes:
    API Key:
      description: >
        The affiliate's API key generated from the Affiliate Portal. Uses the
        X-Eflow-Api-Key header.
      in: header
      name: X-Eflow-Api-Key
      type: apiKey

````