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

# List Charges Table Rows

> Returns a page of charges export rows using the requested columns, filters, sorting, and pagination. Downstream finance systems such as NetSuite, Sage, or ERP middleware typically call `Get Charges Table Definition` first, choose a subset of fields, and then request rows for export, reconciliation, or incremental sync jobs.

Key request fields:

| Input | How downstream systems commonly use it |
| --- | --- |
| `table_data_request.requested_columns` | Select the Cedar fields to include in each exported row. |
| `table_data_request.additional_filters` | Limit the export to a specific invoice, accounting period, billing type, service type, GL code, customer, or other supported charge dimension. |
| `table_data_request.sort_columns` | Create a stable export order for repeatable batching and reconciliation. |
| `page_size`, `page_next_token`, `page_previous_token` | Page through large exports without re-reading the full result set. |

Each row is returned as a column-keyed structure rather than a fixed finance schema, so consumers can request only the columns they actively map into their downstream system.



## OpenAPI

````yaml /user-docs/api-reference/charge.swagger.json post /t/v1/charges-table-rows
openapi: 3.0.1
info:
  title: protobuf/arms/charge.proto
  version: version not set
servers:
  - description: Production (US)
    url: https://api-lg-k-h1.arms.cedarai.com
  - description: Production (EU)
    url: https://api-lg-k-h1.arms.cedarai.se
security:
  - ApiKeyAuth: []
    AssumeUserAuth: []
tags:
  - name: ChargeService
paths:
  /t/v1/charges-table-rows:
    post:
      tags:
        - ChargeService
      summary: List Charges Table Rows
      description: >-
        Returns a page of charges export rows using the requested columns,
        filters, sorting, and pagination. Downstream finance systems such as
        NetSuite, Sage, or ERP middleware typically call `Get Charges Table
        Definition` first, choose a subset of fields, and then request rows for
        export, reconciliation, or incremental sync jobs.


        Key request fields:


        | Input | How downstream systems commonly use it |

        | --- | --- |

        | `table_data_request.requested_columns` | Select the Cedar fields to
        include in each exported row. |

        | `table_data_request.additional_filters` | Limit the export to a
        specific invoice, accounting period, billing type, service type, GL
        code, customer, or other supported charge dimension. |

        | `table_data_request.sort_columns` | Create a stable export order for
        repeatable batching and reconciliation. |

        | `page_size`, `page_next_token`, `page_previous_token` | Page through
        large exports without re-reading the full result set. |


        Each row is returned as a column-keyed structure rather than a fixed
        finance schema, so consumers can request only the columns they actively
        map into their downstream system.
      operationId: ListChargesTableRows
      parameters:
        - description: Carrier ID
          in: header
          name: Carrier
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/armsListChargesTableRowsRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/armsTableData'
          description: A successful response.
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
          description: An unexpected error response.
components:
  schemas:
    armsListChargesTableRowsRequest:
      properties:
        pageNextToken:
          type: string
        pagePreviousToken:
          type: string
        pageSize:
          format: int64
          type: integer
        tableDataRequest:
          $ref: '#/components/schemas/armsRequestTableData'
      type: object
    armsTableData:
      properties:
        nextToken:
          type: string
        prevToken:
          type: string
        rows:
          items:
            $ref: '#/components/schemas/armsRowData'
          type: array
        tableDef:
          $ref: '#/components/schemas/armsTableDef'
      type: object
    rpcStatus:
      properties:
        code:
          format: int32
          type: integer
        details:
          items:
            $ref: '#/components/schemas/protobufAny'
          type: array
        message:
          type: string
      type: object
    armsRequestTableData:
      properties:
        additionalFilters:
          items:
            $ref: '#/components/schemas/armsColumnSearchTerm'
          type: array
        pageNextToken:
          type: string
        pagePreviousToken:
          type: string
        pageSize:
          format: int64
          type: integer
        requestedColumns:
          items:
            $ref: '#/components/schemas/armsColumnSearchTerm'
          type: array
        sortColumns:
          items:
            $ref: '#/components/schemas/armsSortColumn'
          type: array
      type: object
    armsRowData:
      properties:
        data:
          additionalProperties:
            $ref: '#/components/schemas/armsColumnData'
          type: object
        intKey:
          format: int64
          type: string
        stringKey:
          type: string
      type: object
    armsTableDef:
      properties:
        columns:
          items:
            $ref: '#/components/schemas/armsColumnDef'
          type: array
        defaultColumns:
          items:
            type: string
          type: array
      type: object
    protobufAny:
      additionalProperties:
        type: object
      properties:
        '@type':
          type: string
      type: object
    armsColumnSearchTerm:
      properties:
        columnKey:
          type: string
        op:
          $ref: '#/components/schemas/armsRequestOp'
        searchTerm:
          type: string
      type: object
    armsSortColumn:
      properties:
        column:
          type: string
        direction:
          $ref: '#/components/schemas/armsSortDirection'
      type: object
    armsColumnData:
      properties:
        columnKey:
          type: string
        decimalVal:
          $ref: '#/components/schemas/googletypeDecimal'
        intVal:
          format: int64
          type: string
        realVal:
          format: double
          type: number
        secondaryData:
          properties: {}
          type: object
        stringVal:
          type: string
        tsVal:
          format: date-time
          type: string
      type: object
    armsColumnDef:
      properties:
        description:
          type: string
        enumValues:
          items:
            type: string
          type: array
        key:
          type: string
        name:
          type: string
        searchable:
          type: boolean
        type:
          $ref: '#/components/schemas/armsColumnDataType'
      type: object
    armsRequestOp:
      default: RO_DEFAULT
      enum:
        - RO_DEFAULT
        - RO_SUBSTRING
        - RO_EXACT
        - RO_STARTSWITH
        - RO_ENDSWITH
        - RO_EMPTY
        - RO_LT
        - RO_GT
        - RO_LE
        - RO_GE
        - RO_NE
        - RO_BETWEEN
        - RO_NOT_EMPTY
        - RO_NOT_SUBSTRING
        - RO_NOT_STARTSWITH
        - RO_NOT_ENDSWITH
      type: string
    armsSortDirection:
      default: ASCENDING
      enum:
        - ASCENDING
        - DESCENDING
      type: string
    googletypeDecimal:
      properties:
        value:
          type: string
      type: object
    armsColumnDataType:
      default: STRING
      enum:
        - STRING
        - INT
        - REAL
        - TIMESTAMP
        - DECIMAL
      type: string
  securitySchemes:
    ApiKeyAuth:
      in: header
      name: x-arms-api-key
      type: apiKey
    AssumeUserAuth:
      in: header
      name: x-arms-assume-user
      type: apiKey

````