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

# List all invoice payments

> Returns a list of all invoice payments across all clinics in the organization. The payments are sorted by creation date, with the most recent appearing first. When using modified filters, results are sorted by modification date instead.

An **invoice payment** represents a payment allocation applied toward a specific clinic invoice. When a client (pet parent) makes a payment, it is split across one or more invoices as individual invoice payment records, each tracking the amount applied. Invoice payments are never deleted.



## OpenAPI

````yaml get /ext/v2/invoice-payments/
openapi: 3.1.0
info:
  description: ''
  title: NinjaAPI
  version: 2.0.0
servers:
  - url: https://connect.vetcove.com/
security: []
paths:
  /ext/v2/invoice-payments/:
    get:
      tags:
        - Invoices
      summary: List all invoice payments
      description: >-
        Returns a list of all invoice payments across all clinics in the
        organization. The payments are sorted by creation date, with the most
        recent appearing first. When using modified filters, results are sorted
        by modification date instead.


        An **invoice payment** represents a payment allocation applied toward a
        specific clinic invoice. When a client (pet parent) makes a payment, it
        is split across one or more invoices as individual invoice payment
        records, each tracking the amount applied. Invoice payments are never
        deleted.
      operationId: invoicePayments_list
      parameters:
        - description: When provided, filters to objects with these IDs.
          in: query
          name: ids
          required: false
          schema:
            anyOf:
              - items:
                  type: integer
                type: array
              - type: 'null'
            description: When provided, filters to objects with these IDs.
            title: Ids
        - description: >-
            A cursor used for pagination. Fetches the page of results ending
            immediately before the object with the given ID. Cannot be used at
            the same time as `starting_after`.
          in: query
          name: ending_before
          required: false
          schema:
            anyOf:
              - type: integer
              - type: 'null'
            description: >-
              A cursor used for pagination. Fetches the page of results ending
              immediately before the object with the given ID. Cannot be used at
              the same time as `starting_after`.
            title: Ending Before
        - description: >-
            A cursor used for pagination. Fetches the page of results starting
            immediately after the given ID. Cannot be used at the same time as
            `ending_before`.
          in: query
          name: starting_after
          required: false
          schema:
            anyOf:
              - type: integer
              - type: 'null'
            description: >-
              A cursor used for pagination. Fetches the page of results starting
              immediately after the given ID. Cannot be used at the same time as
              `ending_before`.
            title: Starting After
        - description: The maximum number of items to return per page.
          in: query
          name: limit
          required: false
          schema:
            default: 10
            description: The maximum number of items to return per page.
            maximum: 100
            minimum: 1
            title: Limit
            type: integer
        - description: >-
            A cursor token used for pagination. This token contains encoded
            information about the last seen record in order to continue
            pagination. Cannot be used with `starting_after` or `ending_before`
            parameters.
          in: query
          name: cursor
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              A cursor token used for pagination. This token contains encoded
              information about the last seen record in order to continue
              pagination. Cannot be used with `starting_after` or
              `ending_before` parameters.
            title: Cursor
        - description: >-
            Filters to objects modified on or after this datetime (ISO8601 UTC,
            e.g. 2025-08-25T10:30:00Z). Cannot be used with `starting_after` or
            `ending_before` parameters.
          in: query
          name: modified__gte
          required: false
          schema:
            anyOf:
              - format: date-time
                type: string
              - type: 'null'
            description: >-
              Filters to objects modified on or after this datetime (ISO8601
              UTC, e.g. 2025-08-25T10:30:00Z). Cannot be used with
              `starting_after` or `ending_before` parameters.
            title: Modified  Gte
        - description: >-
            Filters to objects modified on or before this datetime (ISO8601 UTC,
            e.g. 2025-08-25T10:30:00Z). Cannot be used with `starting_after` or
            `ending_before` parameters.
          in: query
          name: modified__lte
          required: false
          schema:
            anyOf:
              - format: date-time
                type: string
              - type: 'null'
            description: >-
              Filters to objects modified on or before this datetime (ISO8601
              UTC, e.g. 2025-08-25T10:30:00Z). Cannot be used with
              `starting_after` or `ending_before` parameters.
            title: Modified  Lte
        - description: When provided, filters to invoice payments for this clinic.
          in: query
          name: clinic_id
          required: false
          schema:
            anyOf:
              - type: integer
              - type: 'null'
            description: When provided, filters to invoice payments for this clinic.
            title: Clinic Id
        - description: When provided, filters to invoice payments for this clinic client.
          in: query
          name: clinic_client_id
          required: false
          schema:
            anyOf:
              - type: integer
              - type: 'null'
            description: When provided, filters to invoice payments for this clinic client.
            title: Clinic Client Id
        - description: When provided, filters to invoice payments on this invoice.
          in: query
          name: invoice_id
          required: false
          schema:
            anyOf:
              - type: integer
              - type: 'null'
            description: When provided, filters to invoice payments on this invoice.
            title: Invoice Id
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExternalInvoicePaymentSchemaList'
          description: OK
      security:
        - ExternalAPIAuth: []
components:
  schemas:
    ExternalInvoicePaymentSchemaList:
      properties:
        data:
          description: A single page of data contained within this list.
          items:
            $ref: '#/components/schemas/ExternalInvoicePaymentSchema'
          title: Data
          type: array
        has_more:
          default: false
          description: Whether there are more pages or data in this list.
          title: Has More
          type: boolean
        next_page:
          description: A URL linking to the next page of this list.
          title: Next Page
          type: string
        type:
          default: list
          description: Type of this object. Always `list`.
          title: Type
          type: string
      required:
        - data
        - next_page
      title: ExternalInvoicePaymentSchemaList
      type: object
    ExternalInvoicePaymentSchema:
      properties:
        amount:
          description: The payment amount applied to the invoice, in cents.
          title: Amount
          type: integer
        clinic_client_id:
          description: The ID of the client (pet parent) on the invoice.
          title: Clinic Client Id
          type: integer
        clinic_id:
          description: The ID of the clinic that issued the invoice.
          title: Clinic Id
          type: integer
        created:
          description: The datetime this object was created.
          format: date-time
          title: Created
          type: string
        id:
          description: The unique identifier for the invoice payment.
          title: Id
          type: integer
        invoice_id:
          description: The ID of the invoice this payment is applied to.
          title: Invoice Id
          type: integer
        modified:
          description: >-
            The datetime this object was last modified; changes to related
            entities will not update this field.
          format: date-time
          title: Modified
          type: string
        payment_id:
          anyOf:
            - type: integer
            - type: 'null'
          description: The ID of the payment this invoice payment is linked to, if any.
          title: Payment Id
      required:
        - created
        - modified
        - id
        - invoice_id
        - clinic_id
        - clinic_client_id
        - payment_id
        - amount
      title: ExternalInvoicePaymentSchema
      type: object
  securitySchemes:
    ExternalAPIAuth:
      scheme: bearer
      type: http

````