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

# Get Invoices

> Retrieves a **list of all invoices** across your merchant account, with optional filtering by **Merchant Customer Ref ID**, **Merchant Invoice Ref ID**, **start date**, and **end date**.
Date filters apply to the invoice’s **billing date**.

The endpoint supports pagination via **Page** and **PageSize** query parameters — with a maximum of **100 entries per page**. If not specified, the default is **page 1** with **100 results**.
Use this endpoint to generate invoice reports, build customer dashboards, or review billing activity over a selected period.

Returns `400 Bad Request` for invalid date input.



## OpenAPI

````yaml /api-reference/swagger.json get /api/Invoices
openapi: 3.0.4
info:
  title: Revolv3 OpenApi Spec
  description: Spec for Revolv3
  version: 1.29.2
servers:
  - url: https://api-sandbox.revolv3.com
security: []
paths:
  /api/Invoices:
    get:
      tags:
        - Invoices
      summary: Get Invoices
      description: "Retrieves a **list of all invoices** across your merchant account, with optional filtering by **Merchant Customer Ref ID**, **Merchant Invoice Ref ID**, **start date**, and **end date**.\r\nDate filters apply to the invoice’s **billing date**.\r\n\r\nThe endpoint supports pagination via **Page** and **PageSize** query parameters — with a maximum of **100 entries per page**. If not specified, the default is **page 1** with **100 results**.\r\nUse this endpoint to generate invoice reports, build customer dashboards, or review billing activity over a selected period.\r\n\r\nReturns `400 Bad Request` for invalid date input."
      parameters:
        - name: merchantCustomerRefId
          in: query
          schema:
            maxLength: 100
            minLength: 0
            type: string
        - name: merchantInvoiceRefId
          in: query
          schema:
            maxLength: 100
            minLength: 0
            type: string
        - name: startDate
          in: query
          schema:
            maxLength: 40
            minLength: 0
            type: string
        - name: endDate
          in: query
          schema:
            maxLength: 40
            minLength: 0
            type: string
        - name: page
          in: query
          schema:
            maximum: 1000
            minimum: 1
            type: integer
            format: int32
        - name: pageSize
          in: query
          schema:
            maximum: 100
            minimum: 1
            type: integer
            format: int32
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/VwInvoice'
              example:
                - invoiceId: 1
                  customerId: null
                  merchantInvoiceRefId: 1234-5678-9101
                  binNumber: '411111'
                  last4Digit: '1111'
                  invoiceStatus: Pending
                  subtotal: 60.99
                  tax: 5.4
                  total: 66.39
                  billingDate: 01.06.2026
                  merchantLegalName: null
                  merchantCustomerRefId: null
                  customerFirstName: null
                  customerLastName: null
                - invoiceId: 2
                  customerId: null
                  merchantInvoiceRefId: 1234-5678-9101
                  binNumber: '411111'
                  last4Digit: '1111'
                  invoiceStatus: Pending
                  subtotal: 40.99
                  tax: 3.6
                  total: 43.59
                  billingDate: 01.07.2026
                  merchantLegalName: null
                  merchantCustomerRefId: null
                  customerFirstName: null
                  customerLastName: null
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/VwInvoice'
              example:
                - invoiceId: 1
                  customerId: null
                  merchantInvoiceRefId: 1234-5678-9101
                  binNumber: '411111'
                  last4Digit: '1111'
                  invoiceStatus: Pending
                  subtotal: 60.99
                  tax: 5.4
                  total: 66.39
                  billingDate: 01.06.2026
                  merchantLegalName: null
                  merchantCustomerRefId: null
                  customerFirstName: null
                  customerLastName: null
                - invoiceId: 2
                  customerId: null
                  merchantInvoiceRefId: 1234-5678-9101
                  binNumber: '411111'
                  last4Digit: '1111'
                  invoiceStatus: Pending
                  subtotal: 40.99
                  tax: 3.6
                  total: 43.59
                  billingDate: 01.07.2026
                  merchantLegalName: null
                  merchantCustomerRefId: null
                  customerFirstName: null
                  customerLastName: null
            text/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/VwInvoice'
              example:
                - invoiceId: 1
                  customerId: null
                  merchantInvoiceRefId: 1234-5678-9101
                  binNumber: '411111'
                  last4Digit: '1111'
                  invoiceStatus: Pending
                  subtotal: 60.99
                  tax: 5.4
                  total: 66.39
                  billingDate: 01.06.2026
                  merchantLegalName: null
                  merchantCustomerRefId: null
                  customerFirstName: null
                  customerLastName: null
                - invoiceId: 2
                  customerId: null
                  merchantInvoiceRefId: 1234-5678-9101
                  binNumber: '411111'
                  last4Digit: '1111'
                  invoiceStatus: Pending
                  subtotal: 40.99
                  tax: 3.6
                  total: 43.59
                  billingDate: 01.07.2026
                  merchantLegalName: null
                  merchantCustomerRefId: null
                  customerFirstName: null
                  customerLastName: null
        '400':
          description: Bad Request
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/StatusMessageResponse'
              example:
                message: Unable to perform the request action with provided data.
            application/json:
              schema:
                $ref: '#/components/schemas/StatusMessageResponse'
              example:
                message: Unable to perform the request action with provided data.
            text/json:
              schema:
                $ref: '#/components/schemas/StatusMessageResponse'
              example:
                message: Unable to perform the request action with provided data.
        '401':
          description: Unauthorized
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/StatusMessageResponse'
              example:
                message: Attempted to perform an unauthorized operation.
            application/json:
              schema:
                $ref: '#/components/schemas/StatusMessageResponse'
              example:
                message: Attempted to perform an unauthorized operation.
            text/json:
              schema:
                $ref: '#/components/schemas/StatusMessageResponse'
              example:
                message: Attempted to perform an unauthorized operation.
      security:
        - XRevolv3Token: []
components:
  schemas:
    VwInvoice:
      type: object
      properties:
        invoiceId:
          type: integer
          format: int64
        customerId:
          type: integer
          format: int64
          nullable: true
        merchantInvoiceRefId:
          type: string
          nullable: true
        binNumber:
          type: string
          nullable: true
        last4Digit:
          type: string
          nullable: true
        invoiceStatus:
          type: string
          nullable: true
        subtotal:
          type: number
          format: double
        tax:
          type: number
          format: double
        total:
          type: number
          format: double
        billingDate:
          type: string
          nullable: true
        merchantLegalName:
          type: string
          nullable: true
        merchantCustomerRefId:
          type: string
          nullable: true
        customerFirstName:
          type: string
          nullable: true
        customerLastName:
          type: string
          nullable: true
      additionalProperties: false
    StatusMessageResponse:
      type: object
      properties:
        message:
          type: string
          nullable: true
        errors:
          type: array
          items:
            type: string
          nullable: true
        fluentValidatorErrors:
          type: array
          items:
            $ref: '#/components/schemas/ValidationFailure'
          nullable: true
      additionalProperties: false
    ValidationFailure:
      type: object
      properties:
        propertyName:
          type: string
          nullable: true
        errorMessage:
          type: string
          nullable: true
        attemptedValue:
          nullable: true
        customState:
          nullable: true
        severity:
          $ref: '#/components/schemas/Severity'
        errorCode:
          type: string
          nullable: true
        formattedMessagePlaceholderValues:
          type: object
          additionalProperties:
            nullable: true
          nullable: true
      additionalProperties: false
    Severity:
      enum:
        - Error
        - Warning
        - Info
      type: string
  securitySchemes:
    XRevolv3Token:
      type: apiKey
      in: header
      name: x-revolv3-token

````