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

# List Consumption Records V2



## OpenAPI

````yaml POST /consumption-v2
openapi: 3.1.0
info:
  title: NestVet API
  version: '1.8'
  description: >-
    API for managing subscriptions, pet benefits, payment plans, products,
    invoices, and Stripe-integrated financial data.
servers:
  - url: https://nestvet.com/api/1.1/wf
security: []
paths:
  /consumption-v2:
    post:
      summary: List Consumption Records V2
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConsumptionV2Request'
      responses:
        '200':
          description: A list of consumption records
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Consumption'
      security:
        - bearerAuth: []
components:
  schemas:
    ConsumptionV2Request:
      type: object
      required:
        - organization
        - limit
        - offset
      properties:
        organization:
          type: string
          description: Filter by organization ID
          example: 1700000000000x444444444444444444
        id:
          type: string
          description: Filter by consumption record ID
          example: 1700000000000x000000000000000000
        home_clinic:
          type: string
          description: Filter by home clinic ID
          example: 1700000000000x111111111111111111
        subscription:
          type: string
          description: Filter by subscription ID
          example: 1700000000000x333333333333333333
        pet:
          type: string
          description: Filter by pet ID
          example: 1700000000000x555555555555555555
        invoice_line:
          type: string
          description: Filter by Bubble invoice line ID
          example: 1700000000000x666666666666666666
        invoice_line_id:
          type: string
          description: Filter by PIMS invoice line ID
          example: INV-LINE-789
        product_code:
          type: string
          description: Filter by product code
          example: VACC-RABIES
        modified_since:
          type: string
          format: date-time
          description: 'Filter: internal modified_date >= value'
          example: '2025-01-01T00:00:00Z'
        created_at_since:
          type: string
          format: date-time
          description: 'Filter: bubble created date >= value'
          example: '2025-01-01T00:00:00Z'
        updated_at_since:
          type: string
          format: date-time
          description: 'Filter: bubble modified date >= value'
          example: '2025-01-01T00:00:00Z'
        include_deleted:
          type: boolean
          description: Include soft-deleted rows
          default: false
          example: false
        limit:
          type: integer
          format: int32
          minimum: 1
          maximum: 200
          default: 100
          example: 100
        offset:
          type: integer
          format: int32
          minimum: 0
          default: 0
          example: 0
    Consumption:
      type: object
      properties:
        id:
          type: string
        clinic:
          type: string
        invoice_pims_id:
          type: string
        invoice_date:
          type: string
          format: date-time
        invoice_line:
          type: string
        invoice_line_aje_delta:
          type: number
          format: double
        invoice_line_pims_id:
          type: string
        pet:
          type: string
        pet_benefit:
          type: string
        product_code:
          type: string
        product_name:
          type: string
        qty_available_on_plan:
          type: integer
        qty_consumed:
          type: integer
        qty_consumed_accum:
          type: integer
        qty_in_plan:
          type: integer
        qty_out_of_plan:
          type: integer
        qty_remaining:
          type: integer
        revenue_in_plan_total:
          type: number
          format: double
        revenue_out_of_plan_total:
          type: number
          format: double
        revenue_to_recognize_total:
          type: number
          format: double
        revenue_to_recognize_per_unit:
          type: number
          format: double
        subscription:
          type: string
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````