> ## 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 transactions > Returns a paginated ledger of the transactions recorded with your tax engine for finalized invoices and credit notes, newest recording first. Superseded and voided entries stay in the list as history, so a caller that waits for a document to finish recording must select an entry whose status is `recorded`. Recording happens after the document is finalized, so an empty list can mean that it has not finished yet. Supports filtering by invoice and by credit note. ## OpenAPI ````yaml /api-reference/v2/specs/2026-04-01.json get /tax/transactions 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/transactions: get: tags: - Tax summary: List tax transactions description: >- Returns a paginated ledger of the transactions recorded with your tax engine for finalized invoices and credit notes, newest recording first. Superseded and voided entries stay in the list as history, so a caller that waits for a document to finish recording must select an entry whose status is `recorded`. Recording happens after the document is finalized, so an empty list can mean that it has not finished yet. Supports filtering by invoice and by credit note. operationId: list-tax-transactions parameters: - in: header name: Alguna-Version required: true schema: enum: - '2026-04-01' type: string - explode: false in: query name: credit_note_id schema: description: Return only transactions for these credit notes, comma-separated example: cn_034DG8VMQwhPngo3S9mdKO items: type: string type: array - explode: false in: query name: invoice_id schema: description: Return only transactions for these invoices, comma-separated example: inv_034DG8VMQwhPngo3S9mdKO items: type: string type: array - in: query name: limit schema: description: Transactions to return per page example: 20 format: int32 maximum: 100 type: integer - in: query name: offset schema: default: 0 description: Transactions to skip before the first returned example: 0 format: int32 type: integer responses: '200': content: application/json: schema: $ref: '#/components/schemas/TaxTransactionListResponse' 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: TaxTransactionListResponse: properties: data: description: List of tax transactions items: $ref: '#/components/schemas/TaxTransactionResponse' 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 TaxTransactionResponse: properties: credit_note_id: description: >- Credit note this transaction records. Absent on an invoice's transaction. example: cn_034DG8VMQwhPngo3S9mdKO nullable: true type: string currency: description: ISO 4217 currency code example: USD type: string id: description: Unique identifier for the tax transaction example: taxtxn_034DG8VMQwhPngo3S9mdKO type: string invoice_id: description: >- Invoice this transaction records. Absent on a credit note's transaction. example: inv_034DG8VMQwhPngo3S9mdKO nullable: true type: string kind: allOf: - $ref: '#/components/schemas/TaxTransactionKind' description: Whether the transaction records a sale or reverses one example: record recorded_at: description: When the transaction was recorded with the tax engine example: '2026-11-05T18:30:00Z' format: date-time type: string status: allOf: - $ref: '#/components/schemas/TaxTransactionStatus' description: >- Lifecycle of the transaction. Only a recorded transaction is active; superseded and voided ones are history. example: recorded tax_amount: description: >- Tax recorded with the tax engine, as a decimal string. Negative on a negation. example: '8.25' type: string tax_date: description: Date the tax is assessed on example: '2026-11-05T00:00:00Z' format: date-time type: string required: - currency - id - kind - recorded_at - status - tax_amount - tax_date 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 TaxTransactionKind: enum: - record - negation type: string TaxTransactionStatus: enum: - recorded - superseded - voided type: string 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.