> ## 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: title: Alguna Public API version: '2026-04-01' servers: - url: https://api.alguna.io security: - bearerAuth: [] tags: - name: Billing Events and Metrics - name: Checkout Sessions - name: Credit Notes - name: Credits - name: Customer Portal Sessions - name: Customers - name: Insights - name: Integrations - name: Invoices - name: Payments - name: Plans - name: Product Bundles - name: Products - name: Refunds - name: Revenue Schedules - name: Subscription Changes - name: Subscription Versions - name: Subscriptions - name: Tax - 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 required: true schema: description: Number of items to return per page example: 20 format: int64 type: integer - in: query name: offset required: true schema: description: Number of items to skip example: 0 format: int64 type: integer - in: query name: sort required: true 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: $ref: '#/components/schemas/ErrorResponse' description: Unauthorized '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 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: properties: detail: type: string status: format: int64 type: integer required: - status - detail 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 ````