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

# Get consumptions



## OpenAPI

````yaml GET /lines/{lineId}/products/{productId}/consumptions
openapi: 3.1.0
info:
  title: Wave Lines API
  version: 1.0.0
servers: []
security:
  - client_id: []
    secret_key: []
tags:
  - name: lines
    description: Line lifecycle operations
  - name: payments
    description: Payment listing and lookup
  - name: tax-receipts
    description: Tax receipt listing, lookup and document download
  - name: subscriptions
    description: Subscription lookup, product management and invoices
  - name: holders
    description: Holder (customer) listing, lookup and creation
  - name: usage
    description: 'Usage: per-product line balance and consumption'
  - name: Portability
    description: >-
      Number portability: port-in request creation, listing, modification and
      cancellation, plus the consolidated portability status
  - name: Inventory
    description: >-
      Inventory resource pools: pool listing, the resources held in a pool and
      resource reservations
  - name: Catalog
    description: Catalog offers exposed by the Wave Catalog API
paths:
  /lines/{lineId}/products/{productId}/consumptions:
    get:
      tags:
        - usage
      parameters:
        - schema:
            type: string
            enum:
              - hour
              - day
              - month
          in: query
          name: granularity
          required: true
        - schema:
            type: string
            pattern: ^\d{4}-\d{2}-\d{2}$
          in: query
          name: startDate
          required: true
        - schema:
            type: string
            pattern: ^\d{4}-\d{2}-\d{2}$
          in: query
          name: endDate
          required: true
        - schema:
            anyOf:
              - type: string
                format: uuid
              - type: array
                items:
                  type: string
                  format: uuid
          in: query
          name: componentId
          required: false
        - schema:
            type: string
            default: UTC
          in: query
          name: tz
          required: false
        - schema:
            type: number
            exclusiveMinimum: 0
            default: 1
          in: query
          name: page
          required: false
        - schema:
            type: number
            exclusiveMinimum: 0
            maximum: 100
            default: 10
          in: query
          name: pageSize
          required: false
        - schema:
            type: string
            format: uuid
          in: path
          name: lineId
          required: true
        - schema:
            type: string
            format: uuid
          in: path
          name: productId
          required: true
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        componentId:
                          type: string
                        unit:
                          type: string
                        buckets:
                          type: array
                          items:
                            type: object
                            properties:
                              start:
                                type: string
                              end:
                                type: string
                              value:
                                type: number
                            required:
                              - start
                              - end
                              - value
                            additionalProperties: false
                      required:
                        - componentId
                        - unit
                        - buckets
                      additionalProperties: false
                  meta:
                    type: object
                    properties:
                      total:
                        type: integer
                        minimum: 0
                      page:
                        type: integer
                      pageSize:
                        type: integer
                      totalPages:
                        type: integer
                        minimum: 0
                      lineId:
                        type: string
                      productId:
                        type: string
                      granularity:
                        type: string
                        enum:
                          - hour
                          - day
                          - month
                      tz:
                        type: string
                      startDate:
                        type: string
                      endDate:
                        type: string
                    required:
                      - total
                      - page
                      - pageSize
                      - totalPages
                      - lineId
                      - productId
                      - granularity
                      - tz
                      - startDate
                      - endDate
                    additionalProperties: false
                required:
                  - items
                  - meta
                additionalProperties: false
components:
  securitySchemes:
    client_id:
      type: apiKey
      in: header
      name: client_id
    secret_key:
      type: apiKey
      in: header
      name: secret_key

````