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

# List tax calculations

> Returns a paginated list of stored calculations, newest first, for reconciling what was quoted against what was issued. Each entry carries the total tax, whether the calculation was issued from and into which invoice, and whether it can still be issued from. Supports filtering by customer reference, currency, issued and expired state, and a tax date range. Per-line tax is on the get endpoint, not here.



## OpenAPI

````yaml /api-reference/v2/specs/2026-04-01.json get /tax/calculations
openapi: 3.1.0
info:
  description: >-
    Alguna is the AI-native quote-to-revenue platform for B2B companies: CPQ,
    subscription and usage-based billing, invoicing, payment collection, and
    revenue recognition in one system of record. The API operates on one
    versioned agreement per customer: quotes, subscriptions and their versions,
    usage, invoices, payments, and revenue schedules read from it. Official
    SDKs: TypeScript (@alguna/sdk), Python (alguna), Go
    (github.com/alguna-io/alguna-go), Rust (alguna), and the alguna CLI
    (@alguna/cli).
  title: Alguna Public API
  version: '2026-04-01'
servers:
  - url: https://api.alguna.io
    x-fern-server-name: Production
security:
  - bearerAuth: []
tags:
  - name: Billing Events and Metrics
  - name: Checkout Sessions
  - name: Credit Notes
  - name: Credits
  - name: Customer Portal Sessions
  - name: Customers
  - name: Feedback
  - name: Insights
  - name: Integrations
  - name: Invoices
  - name: Merchants
  - name: Payments
  - name: Plans
  - name: Product Bundles
  - name: Products
  - name: Quotes
  - name: Refunds
  - name: Revenue Schedules
  - name: Subscription Changes
  - name: Subscription Versions
  - name: Subscriptions
  - name: Tags
  - name: Tax
  - name: Users
  - name: Wallet Grants
  - name: Wallets
paths:
  /tax/calculations:
    get:
      tags:
        - Tax
      summary: List tax calculations
      description: >-
        Returns a paginated list of stored calculations, newest first, for
        reconciling what was quoted against what was issued. Each entry carries
        the total tax, whether the calculation was issued from and into which
        invoice, and whether it can still be issued from. Supports filtering by
        customer reference, currency, issued and expired state, and a tax date
        range. Per-line tax is on the get endpoint, not here.
      operationId: list-tax-calculations
      parameters:
        - in: header
          name: Alguna-Version
          required: true
          schema:
            enum:
              - '2026-04-01'
            type: string
        - in: query
          name: consumed
          schema:
            description: Filter by whether an invoice has been issued from the calculation
            type: boolean
        - explode: false
          in: query
          name: currency
          schema:
            description: Filter by currency. Pass a comma-separated list to match any.
            example: USD
            items:
              type: string
            type: array
        - explode: false
          in: query
          name: customer_reference
          schema:
            description: >-
              Filter by your own buyer id. Pass a comma-separated list to match
              any.
            example: cust_ext_42
            items:
              type: string
            type: array
        - in: query
          name: expired
          schema:
            description: Filter by whether the calculation can still be issued from
            type: boolean
        - in: query
          name: limit
          schema:
            description: Number of items to return per page
            example: 20
            format: int32
            maximum: 100
            type: integer
        - in: query
          name: offset
          schema:
            default: 0
            description: Number of items to skip
            example: 0
            format: int32
            type: integer
        - in: query
          name: sort
          schema:
            description: >-
              Sort field and direction in format field:order. Sortable fields:
              created_at, tax_date, expires_at, total_tax, currency.
            example: created_at:desc
            type: string
        - in: query
          name: tax_date_gte
          schema:
            description: Tax date lower bound (inclusive)
            example: '2026-01-01T00:00:00Z'
            format: date-time
            type: string
        - in: query
          name: tax_date_lte
          schema:
            description: Tax date upper bound (inclusive)
            example: '2026-12-31T00:00:00Z'
            format: date-time
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaxCalculationListResponse'
          description: Success
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/ErrorResponse'
                  - $ref: '#/components/schemas/GatewayErrorResponse'
          description: Unauthorized
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Forbidden — the organization does not have access to this feature
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Not Found
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unprocessable Entity
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Internal Server Error
        '502':
          description: >-
            Bad Gateway — sent by the infrastructure in front of the API; the
            body is not JSON. Safe to retry.
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: >-
            Service Unavailable — a dependency is temporarily unavailable. Retry
            with backoff.
        '504':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: >-
            Gateway Timeout — the request did not finish in time. Retry with
            backoff; use an idempotency key for writes.
components:
  schemas:
    TaxCalculationListResponse:
      properties:
        data:
          description: List of tax calculations
          items:
            $ref: '#/components/schemas/TaxCalculationListItemResponse'
          type: array
        pagination:
          allOf:
            - $ref: '#/components/schemas/PaginationMeta'
          description: Pagination metadata
      required:
        - data
        - pagination
      type: object
    ErrorResponse:
      description: The body of every error the API returns.
      properties:
        detail:
          description: Explanation of what went wrong
          type: string
        status:
          description: HTTP status code of the response
          format: int64
          type: integer
        title:
          description: >-
            HTTP status text. Sent only by version, idempotency and
            credit-refusal errors.
          type: string
        type:
          description: Always `about:blank`. Sent only by version and idempotency errors.
          type: string
      required:
        - status
        - detail
      type: object
    GatewayErrorResponse:
      description: >-
        Returned by the API gateway when a request carries no valid API key,
        before the API handles it.
      properties:
        code:
          description: Machine-readable error code, e.g. `unauthenticated`
          type: string
        details:
          nullable: true
          type: object
        message:
          description: Explanation of what went wrong
          type: string
      required:
        - code
        - message
      type: object
    TaxCalculationListItemResponse:
      properties:
        consumed_at:
          description: When an invoice was issued from this calculation
          format: date-time
          nullable: true
          type: string
        created_at:
          description: When the calculation was made
          format: date-time
          type: string
        currency:
          description: Currency of the amounts
          example: USD
          type: string
        customer_reference:
          description: >-
            Your own id for the buyer, as sent; absent when the calculation was
            for a guest
          nullable: true
          type: string
        expired:
          description: Whether the calculation can no longer be issued from
          type: boolean
        expires_at:
          description: When the calculation stops being issuable
          format: date-time
          type: string
        id:
          description: Id of the calculation
          type: string
        invoice_id:
          description: Invoice this calculation was issued into, when it has been
          nullable: true
          type: string
        line_count:
          description: Number of lines on the calculation
          example: 2
          format: int64
          type: integer
        tax_date:
          description: Date tax was assessed on
          format: date-time
          type: string
        total_tax:
          description: Sum of per-line tax amounts
          example: '6.60'
          type: string
      required:
        - created_at
        - currency
        - expired
        - expires_at
        - id
        - line_count
        - tax_date
        - total_tax
      type: object
    PaginationMeta:
      properties:
        per_page:
          description: Number of items returned per page
          example: 20
          format: int64
          type: integer
        total_pages:
          description: Total number of pages available
          example: 5
          format: int64
          type: integer
      required:
        - per_page
        - total_pages
      type: object
  securitySchemes:
    bearerAuth:
      bearerFormat: API Key
      description: API key authentication. Pass your API key as a Bearer token.
      scheme: bearer
      type: http
      x-fern-bearer:
        env: ALGUNA_API_KEY
        name: apiKey

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.