Skip to main content
Taxjar logo
  • Category: taxes
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 21
  • Triggers: 0
  • Slug: TAXJAR
  • Version: 20261101_00

Tools

Slug: TAXJAR_CALCULATE_SALES_TAX_FOR_AN_ORDERCalculate sales tax for an order using origin and destination details, the order amount and shipping, and optional nexus addresses, line items, and exemptions. The result includes the tax to collect and, when available, a breakdown by jurisdiction, shipping, and line item.

Input Parameters

number
required
Order amount (excluding shipping)
string
required
Destination ZIP or postal code
string
Destination city
string
required
Origin ZIP or postal code
number
required
Shipping cost for the order
string
required
Destination state or province
string
Origin city
string
Destination street address
string
required
Origin state or province
array
List of line items in the order
string
required
Destination country code (ISO 3166-1 alpha-2)
string
Identifier for the customer, if known
string
Origin street address
string
required
Origin country code (ISO 3166-1 alpha-2)
string
Type of exemption for the order (e.g., wholesale, government, non_profit, other)
array
List of seller nexus addresses to consider for tax calculations

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TAXJAR_CREATE_CUSTOMERTool to create a new customer with exemption information. Use when you need to add a customer to your TaxJar account for tax exemption management.

Input Parameters

string
Postal code for the customer’s primary address
string
City for the customer’s primary address
string
required
Full name of the customer or organization
string
Two-letter ISO state code for the customer’s primary address (e.g., ‘CA’, ‘NY’)
string
Street address for the customer’s primary address
string
Two-letter ISO country code for the customer’s primary address (e.g., ‘US’, ‘CA’)
string
required
Unique identifier for the customer. This ID will be used to reference the customer in future API calls.
array
List of regions where the customer is exempt from taxes. Each region must specify both country and state.
string ("wholesale" | "government" | "other" | "non_exempt")
required
Type of tax exemption for the customer. Determines how tax calculations will be applied.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TAXJAR_CREATE_ORDER_TRANSACTIONCreates an order transaction in TaxJar for sales tax reporting and filing, using an origin address on file. The order amount includes shipping but excludes sales tax.

Input Parameters

number
required
Total amount of the order including shipping, excluding sales tax. If line_items are provided, must equal sum of (quantity * unit_price - discount) for all items plus shipping.
number
Latitude of the destination address
number
Longitude of the destination address
string
required
Postal code of the order destination
string
City of the order destination
string
Identifier of the user associated with the transaction
number
required
Total shipping amount for the order
string
required
Two-letter state code for the order destination
number
Sales tax collected for the order
string
Street address of the order destination
array
Line items in the order. If provided, sum of (quantity * unit_price - discount) must equal amount minus shipping.
string
required
Two-letter ISO country code of the order destination
string ("wholesale" | "government" | "marketplace" | "other" | "non_exempt")
Type of exemption if applicable. Must be ‘non_exempt’ or ‘marketplace’ if sales_tax is non-zero.
string
required
Unique identifier for the transaction
array
Nexus addresses associated with the transaction
string
required
Date/time when transaction occurred (ISO 8601 format)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TAXJAR_CREATE_REFUND_TRANSACTIONCreates a refund transaction for an original order in TaxJar. This tool requires an origin address on file in TaxJar.

Input Parameters

number
required
Total amount refunded (negative value, excluding shipping & tax)
string
required
Postal code of refund destination
string
City of refund destination
string
E-commerce provider for the transaction
number
Total shipping refunded (negative for refund)
string
required
Two-letter state code for the refund destination
number
Total sales tax refunded (negative for refund)
string
Street address of refund destination
array
Line items detail for the refunded transaction
string
required
Two-letter ISO country code of refund destination
string
required
Unique identifier for the refund transaction
string
required
Date/time when refund occurred (ISO 8601 format)
string
required
Identifier of the original order being refunded

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TAXJAR_DELETE_CUSTOMERTool to delete an existing customer. Use when you need to remove a previously created customer by its ID. Example: “Delete customer cust_12345”.

Input Parameters

string
required
Unique identifier of the customer to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TAXJAR_DELETE_ORDER_TRANSACTIONTool to delete an existing order transaction. Use when you need to remove a previously created order transaction by its ID. Example: “Delete transaction abc123”.

Input Parameters

string
required
Unique identifier of the order transaction to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TAXJAR_DELETE_REFUND_TRANSACTIONTool to delete an existing refund transaction. Use when you need to remove a previously created refund transaction by its ID. Example: “Delete refund 243345”.

Input Parameters

string
required
Unique identifier of the refund transaction to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TAXJAR_LIST_CUSTOMERSLists customer IDs for customers created through the TaxJar API. Accepts page and per-page parameters and returns customer ID strings.

Input Parameters

integer
Page number for pagination, starting at 1. Use this to navigate through multiple pages of customers.
integer
Maximum number of customer IDs to return per page. Must be between 1 and 100.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TAXJAR_LIST_NEXUS_REGIONSTool to list existing nexus regions for an account. Use after authenticating your account to discover where you have nexus for sales tax purposes.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TAXJAR_LIST_ORDER_TRANSACTIONSList order transaction IDs within a date range. Returns an array of transaction IDs (strings) for orders created between the specified dates. Use this to discover which orders exist in a date range, then use SHOW_ORDER_TRANSACTION to get details for specific IDs.

Input Parameters

string
Filter by provider source, e.g., ‘api’ or ‘csv’. Defaults to ‘api’ if not specified.
string
required
End date for filtering order transactions (YYYY-MM-DD or YYYY/MM/DD). Required parameter.
string
required
Start date for filtering order transactions (YYYY-MM-DD or YYYY/MM/DD). Required parameter.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TAXJAR_LIST_REFUND_TRANSACTIONSLists refund transaction IDs within a specified date range. Returns an array of transaction IDs only. To get detailed information about a specific refund, use the ‘Show refund transaction’ action with the ID. Useful for finding refunds created through the TaxJar API within a specific time period.

Input Parameters

string
Filter by provider source (e.g., ‘api’, ‘csv’)
string
required
End date for filtering refund transactions (format: YYYY/MM/DD or YYYY-MM-DD)
string
required
Start date for filtering refund transactions (format: YYYY/MM/DD or YYYY-MM-DD)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TAXJAR_LIST_TAX_CATEGORIESTool to list all product tax categories and their codes. Use when you need to discover available tax categories before assigning them to products.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TAXJAR_SHOW_CUSTOMERTool to show an existing customer. Use when you need to retrieve details of a specific customer via TaxJar API.

Input Parameters

string
required
Unique identifier for the customer

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TAXJAR_SHOW_ORDER_TRANSACTIONTool to show an existing order transaction by ID. Use when you need to retrieve full details of a specific order transaction after creation or listing.

Input Parameters

string
required
The unique identifier for the order transaction

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TAXJAR_SHOW_REFUND_TRANSACTIONRetrieves detailed information about a specific refund transaction from TaxJar. Use this tool when you need to: - View complete details of a refund transaction including amounts, addresses, and line items - Verify refund transaction data that was previously created - Audit refund information for tax reporting purposes Requires a valid transaction_id that was previously created through TaxJar’s API.

Input Parameters

string
required
The unique ID of the refund transaction to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TAXJAR_SHOW_TAX_RATES_FOR_A_LOCATIONRetrieve sales tax rates for a ZIP code, optionally specifying country, state, city, and street. The result provides the combined location rate and jurisdictional rates; it is not an order-specific tax calculation and does not determine nexus or apply product or customer exemptions.

Input Parameters

string
required
ZIP code to retrieve rates for
string
City name
string
State abbreviation
string
Street address
string
Two-letter country code (ISO-2), default ‘US’

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TAXJAR_SUMMARIZE_TAX_RATES_FOR_ALL_REGIONSTool to retrieve minimum and average sales tax rates by region. Use when you need a backup of regional tax summary rates.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TAXJAR_UPDATE_CUSTOMERTool to update an existing customer in TaxJar. Use when you need to modify customer details such as exemption type, name, or address information.

Input Parameters

string
Postal code
string
City
string
required
Customer name
string
Two-letter ISO state code
string
Street address
string
Two-letter ISO country code
string
required
Unique identifier of the customer to update
array
Regions where the customer is exempt from sales tax
string ("wholesale" | "government" | "marketplace" | "other" | "non_exempt")
required
Type of exemption for the customer (wholesale, government, marketplace, other, or non_exempt)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TAXJAR_UPDATE_ORDER_TRANSACTIONRequest an update to an existing API-created order transaction by transaction ID, for example to adjust its amount, shipping, sales tax, destination, or line items. TaxJar returns details of the updated order.

Input Parameters

number
Total amount of the order
string
Postal code of the order destination
string
City of the order destination
string
Transaction provider, e.g., ‘api’, ‘csv’
number
Total shipping amount for the order
string
Two-letter state code for the order destination
number
Sales tax collected for the order
string
Street address of the order destination
array
Line items in the order
string
Two-letter ISO country code of the order destination
string
required
Unique identifier for the transaction to update
string
Date/time when transaction occurred (ISO 8601 format)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TAXJAR_UPDATE_REFUND_TRANSACTIONTool to update an existing refund transaction. Use when adjusting refund details such as amount, shipping, or line items after creation.

Input Parameters

number
Total amount of the refund excluding shipping
string
Postal code of destination
string
City of destination
string
Postal code of origin
number
Total amount of shipping refunded
string
Two-letter ISO state code of destination
string
City of origin
number
Total amount of sales tax refunded
string
Street address of destination
string
Two-letter ISO state code of origin
array
Line items for the refund
string
Two-letter ISO country code of destination
string
Unique identifier of the customer
string
Street address of origin
string
Two-letter ISO country code of origin
string ("wholesale" | "government" | "marketplace" | "other" | "non_exempt")
Type of exemption for the refund
string
required
Unique identifier for the refund transaction to update
string
Date the transaction was recorded (YYYY-MM-DD format)
string
Unique identifier of the original order transaction

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TAXJAR_VALIDATE_VAT_NUMBERValidates EU VAT identification numbers against the VIES (VAT Information Exchange System) database. Use this tool to: - Verify VAT number format and validity - Check if a VAT number is registered and active in the EU - Retrieve associated company name and address when available - Confirm tax-exempt eligibility before processing transactions The validation queries the European VIES database when available, returning company details for valid registrations. When VIES is unavailable, it falls back to format-based validation using regex patterns.

Input Parameters

string
required
VAT identification number to validate. Must include the two-letter country code prefix (e.g., ‘FR40303265045’, ‘DE123456789’, ‘NL123456789B01’). This endpoint validates EU VAT numbers against the VIES (VAT Information Exchange System) database.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not