> ## 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



## OpenAPI

````yaml POST /consumption
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:
    post:
      summary: List Consumption Records
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConsumptionRequest'
      responses:
        '200':
          description: A list of consumption records
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Consumption'
      security:
        - bearerAuth: []
components:
  schemas:
    ConsumptionRequest:
      allOf:
        - $ref: '#/components/schemas/PaginationRequest'
        - type: object
          properties:
            clinic:
              type: string
            id:
              type: string
            invoice_line_id:
              type: string
            invoice_line_pims_id:
              type: string
            subscription_id:
              type: string
            created_at_since:
              type: string
              format: date-time
            updated_at_since:
              type: string
              format: date-time
    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
    PaginationRequest:
      type: object
      required:
        - organization
        - limit
        - offset
      properties:
        organization:
          type: string
        limit:
          type: integer
          format: int32
        offset:
          type: integer
          format: int32
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````