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

# Get Charges Table Summary

> Returns aggregate summary values for the charges table using the requested filters and aggregations, without returning full row detail. Downstream finance systems can use this endpoint to validate export scope, reconcile totals, and compare Cedar results against imported batches in NetSuite, Sage, or another ERP.

Common reconciliation patterns:

| Aggregate request | Typical downstream use |
| --- | --- |
| `COUNT` on `chargeId` | Confirm the number of charges in an export batch. |
| `SUM` on `amount` | Compare Cedar totals with external invoice or journal totals. |
| `SUM` on `adjustment_total` | Measure the net effect of adjustments before posting. |
| `MIN` / `MAX` on `appliedAt` | Verify the date window covered by an incremental export. |

Use the same filter set you would pass to `List Charges Table Rows` when you want summary numbers for the exact same population of charges.



## OpenAPI

````yaml /user-docs/api-reference/charge.swagger.json post /t/v1/charges-table-summary
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-summary:
    post:
      tags:
        - ChargeService
      summary: Get Charges Table Summary
      description: >-
        Returns aggregate summary values for the charges table using the
        requested filters and aggregations, without returning full row detail.
        Downstream finance systems can use this endpoint to validate export
        scope, reconcile totals, and compare Cedar results against imported
        batches in NetSuite, Sage, or another ERP.


        Common reconciliation patterns:


        | Aggregate request | Typical downstream use |

        | --- | --- |

        | `COUNT` on `chargeId` | Confirm the number of charges in an export
        batch. |

        | `SUM` on `amount` | Compare Cedar totals with external invoice or
        journal totals. |

        | `SUM` on `adjustment_total` | Measure the net effect of adjustments
        before posting. |

        | `MIN` / `MAX` on `appliedAt` | Verify the date window covered by an
        incremental export. |


        Use the same filter set you would pass to `List Charges Table Rows` when
        you want summary numbers for the exact same population of charges.
      operationId: ListChargesTableSummary
      parameters:
        - description: Carrier ID
          in: header
          name: Carrier
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/armsGetTableSummaryRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/armsGetTableSummaryResponse'
          description: A successful response.
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
          description: An unexpected error response.
components:
  schemas:
    armsGetTableSummaryRequest:
      properties:
        aggregates:
          items:
            $ref: '#/components/schemas/armsColumnsToAggregate'
          type: array
        filters:
          items:
            $ref: '#/components/schemas/armsColumnSearchTerm'
          type: array
      type: object
    armsGetTableSummaryResponse:
      properties:
        aggregates:
          items:
            $ref: '#/components/schemas/armsAggregateData'
          type: array
      type: object
    rpcStatus:
      properties:
        code:
          format: int32
          type: integer
        details:
          items:
            $ref: '#/components/schemas/protobufAny'
          type: array
        message:
          type: string
      type: object
    armsColumnsToAggregate:
      properties:
        columnKey:
          type: string
        op:
          $ref: '#/components/schemas/armsAggregateOp'
      type: object
    armsColumnSearchTerm:
      properties:
        columnKey:
          type: string
        op:
          $ref: '#/components/schemas/armsRequestOp'
        searchTerm:
          type: string
      type: object
    armsAggregateData:
      properties:
        columnKey:
          type: string
        intVal:
          format: int64
          type: string
        op:
          $ref: '#/components/schemas/armsAggregateOp'
        realVal:
          format: double
          type: number
        stringVal:
          type: string
      type: object
    protobufAny:
      additionalProperties:
        type: object
      properties:
        '@type':
          type: string
      type: object
    armsAggregateOp:
      default: AO_UNSPECIFIED
      enum:
        - AO_UNSPECIFIED
        - AO_COUNT
        - AO_SUM
        - AO_AVG
        - AO_MIN
        - AO_MAX
        - AO_STRING_CONCAT
        - AO_STRING_CONCAT_DISTINCT
      type: string
    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
  securitySchemes:
    ApiKeyAuth:
      in: header
      name: x-arms-api-key
      type: apiKey
    AssumeUserAuth:
      in: header
      name: x-arms-assume-user
      type: apiKey

````