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

# Get revenue recognition waterfall cell

> List the schedules and slices contributing to a waterfall cell.



## OpenAPI

````yaml get /v1/accounting/revrec/waterfall/cell
openapi: 3.1.0
info:
  title: Hyperline API
  version: 0.0.0
servers:
  - url: https://api.hyperline.co
  - url: https://sandbox.api.hyperline.co
security: []
paths:
  /v1/accounting/revrec/waterfall/cell:
    get:
      tags:
        - Accounting > Revenue recognition
      summary: Get revenue recognition waterfall cell
      description: List the schedules and slices contributing to a waterfall cell.
      operationId: getRevRecWaterfallCell
      parameters:
        - schema:
            type:
              - number
              - 'null'
            minimum: 0
            maximum: 100
            default: 50
          required: false
          name: take
          in: query
        - schema:
            type:
              - number
              - 'null'
            minimum: 0
            default: 0
          required: false
          name: skip
          in: query
        - schema:
            type: string
            description: Ledger identifier.
          required: true
          description: Ledger identifier.
          name: ledger_id
          in: query
        - schema:
            type: string
            pattern: ^\d{4}-(0[1-9]|1[0-2])$
            description: Booked month formatted YYYY-MM; required if year is absent.
          required: false
          description: Booked month formatted YYYY-MM; required if year is absent.
          name: booked_month
          in: query
        - schema:
            type: integer
            minimum: 2000
            maximum: 2100
            description: Booked year; required if booked_month is absent.
          required: false
          description: Booked year; required if booked_month is absent.
          name: year
          in: query
        - schema:
            type: string
            pattern: ^\d{4}-(0[1-9]|1[0-2])$
            description: Recognition month formatted YYYY-MM.
          required: false
          description: Recognition month formatted YYYY-MM.
          name: recognition_month
          in: query
        - schema:
            type: string
            enum:
              - booked
              - recognition
              - remaining
            description: Waterfall cell category.
          required: true
          description: Waterfall cell category.
          name: cell_type
          in: query
        - schema:
            type: string
            enum:
              - pending
              - recognized
              - reversed
            description: Recognition status filter.
          required: false
          description: Recognition status filter.
          name: status
          in: query
        - schema:
            type: string
            description: Comma-separated customer identifiers.
          required: false
          description: Comma-separated customer identifiers.
          name: customer_id__in
          in: query
        - schema:
            type: string
            description: Comma-separated product identifiers.
          required: false
          description: Comma-separated product identifiers.
          name: product_id__in
          in: query
        - schema:
            type: string
            description: Search customer, product, invoice, or schedule data.
          required: false
          description: Search customer, product, invoice, or schedule data.
          name: search
          in: query
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountingRevRecWaterfallCellPaginated'
      security:
        - bearer: []
components:
  schemas:
    AccountingRevRecWaterfallCellPaginated:
      type: object
      properties:
        meta:
          $ref: '#/components/schemas/AccountingPaginationMeta'
        data:
          type: array
          items:
            $ref: '#/components/schemas/AccountingRevRecWaterfallCellItem'
          description: Contributions to the waterfall cell.
      required:
        - meta
        - data
    AccountingPaginationMeta:
      type: object
      properties:
        total:
          type: number
          description: Total number of matching resources.
        taken:
          type: number
          description: Number of resources returned.
        skipped:
          type: number
          description: Number of resources skipped.
      required:
        - total
        - taken
        - skipped
      description: Pagination metadata.
    AccountingRevRecWaterfallCellItem:
      type: object
      properties:
        customer_id:
          type:
            - string
            - 'null'
          description: Related customer identifier.
        customer_name:
          type:
            - string
            - 'null'
          description: Related customer name.
        invoice_id:
          type:
            - string
            - 'null'
          description: Related invoice identifier.
        invoice_ref:
          type:
            - string
            - 'null'
          description: Related invoice reference.
        line_item_name:
          type:
            - string
            - 'null'
          description: Related invoice line-item or product name.
        amount:
          type: number
          description: Amount contributed to the selected cell.
        status:
          type:
            - string
            - 'null'
          enum:
            - pending
            - recognized
            - reversed
            - cancelled
          description: Recognition status of the contribution.
        schedule_id:
          type: string
          description: Recognition-schedule identifier.
        slice_id:
          type:
            - string
            - 'null'
          description: Recognition-slice identifier.
        subscription_id:
          type:
            - string
            - 'null'
          description: Related subscription identifier.
        product_id:
          type:
            - string
            - 'null'
          description: Related product identifier.
        period_starts_at:
          type:
            - string
            - 'null'
          format: date
          description: Inclusive service-period start timestamp.
        period_ends_at:
          type:
            - string
            - 'null'
          format: date
          description: Inclusive service-period end timestamp.
        method:
          type:
            - string
            - 'null'
          enum:
            - none
            - point_in_time
            - over_time
            - usage_based
            - milestone
            - manual
          description: Revenue-recognition method.
        recognition_date:
          type:
            - string
            - 'null'
          format: date
          description: Recognition timestamp.
        schedule_status:
          type: string
          enum:
            - pending
            - in_progress
            - completed
            - cancelled
          description: Status of the schedule.
        schedule_period_starts_at:
          type:
            - string
            - 'null'
          format: date
          description: Inclusive schedule service-period start timestamp.
        schedule_period_ends_at:
          type:
            - string
            - 'null'
          format: date
          description: Inclusive schedule service-period end timestamp.
        origin:
          type: string
          enum:
            - auto
            - manual
          description: Origin of the schedule.
        journal_entry_id:
          type:
            - string
            - 'null'
          description: Related manual journal-entry identifier.
      required:
        - customer_id
        - customer_name
        - invoice_id
        - invoice_ref
        - line_item_name
        - amount
        - status
        - schedule_id
        - slice_id
        - subscription_id
        - product_id
        - period_starts_at
        - period_ends_at
        - method
        - recognition_date
        - schedule_status
        - schedule_period_starts_at
        - schedule_period_ends_at
        - origin
        - journal_entry_id
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT

````