Sign in

v1

latestOpenAPI 3.0.1MIT2026-07-13153492.5 KB

Retrieve the details of a specific transaction

get/tax/transactions/{transaction_id}

Path parameters

transaction_idstring required

The ID of the transaction to retrieve

Response

Transaction details

idstring

The ID of the transaction. We highly recommend you store this value. If you need to refund or query the data from this transaction, you will use this ID as a reference.

objectstring

The type of object: tax.transaction.

calculation_idstring

The ID of the calculation that was used to create this transaction

reference_order_idstring

The unique order ID you provided when creating the transaction

transaction_processed_atnumber

Unix timestamp in seconds representing the date and time your sale was made. If not provided, the date and time this transaction was created

customer_currency_codestring

The ISO-4217 currency code of the transaction

filing_currency_codestring

The currency code of the filing that will be used to remit taxes collected on this transaction

testmodeboolean

True if using a production API key. If true, Numeral will record this transaction towards your nexus totals. If you're registered and collecting in the relevant jurisdiction, we'll file the tax.

Example response

{
  "id": "tr_123456789",
  "object": "tax.transaction",
  "calculation_id": "calc_123456789",
  "reference_order_id": "343-45836",
  "transaction_processed_at": 1714787673,
  "customer_currency_code": "USD",
  "filing_currency_code": "USD",
  "line_items": [
    {
      "product": {
        "reference_product_name": "Widget",
        "reference_line_item_id": "line_987654321",
        "reference_product_id": "p-1233543",
        "product_tax_code": "GENERAL_MERCHANDISE"
      },
      "tax_jurisdictions": [
        {
          "tax_rate": 0.07,
          "tax_due_decimal": 700,
          "rate_type": "GENERAL STATE SALES TAX",
          "tax_authority_name": "Tennessee",
          "tax_type": "SALES"
        }
      ],
      "quantity": 2,
      "tax_amount": 14,
      "amount_excluding_tax": 200,
      "amount_including_tax": 214
    }
  ],
  "metadata": {
    "example_key": "example_value"
  }
}