/taxjar | Type: Application | PCID required: Yes
Tools
| Tool | Description |
|---|---|
taxjar_calculate_tax | Calculate the sales tax for a given order. Requires shipping destination and at least one line item. |
taxjar_create_customer | Create a customer with a tax exemption profile. |
taxjar_create_order_transaction | Create an order transaction for tax reporting. Records a completed order in TaxJar. |
taxjar_create_refund_transaction | Create a refund transaction for tax reporting. Records a completed refund in TaxJar. |
taxjar_delete_order_transaction | Delete an existing order transaction by transaction ID. |
taxjar_delete_refund_transaction | Delete an existing refund transaction by transaction ID. |
taxjar_list_categories | List all TaxJar product tax categories. Returns categories with their name, description, and product_tax_code for use in tax calculations. |
taxjar_list_customers | List customers with tax exemption profiles. |
taxjar_list_order_transactions | List order transactions. Optionally filter by date range, provider, or transaction source. |
taxjar_list_refund_transactions | List refund transactions. Optionally filter by date range or provider. |
taxjar_list_summary_rates | List minimum and average tax rates by region. Returns tax rate summaries for all US states and territories. |
taxjar_show_customer | Show details of a specific customer and their tax exemption profile. |
taxjar_show_order_transaction | Show details of a specific order transaction by transaction ID. |
taxjar_show_refund_transaction | Show details of a specific refund transaction by transaction ID. |
taxjar_show_tax_rates | Show tax rates for a specific location by ZIP code. Optionally provide city, state, and country for more accurate results. |
taxjar_update_order_transaction | Update an existing order transaction. All fields are optional except transaction_id. |
taxjar_update_refund_transaction | Update an existing refund transaction. All fields are optional except transaction_id. |
taxjar_validate_address | Validate a shipping address. Returns a validated and standardized version of the address. |
taxjar_calculate_tax
Calculate the sales tax for a given order. Requires shipping destination and at least one line item. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
from_country | string | No | — | Two-letter ISO country code of the ship-from address |
from_zip | string | No | — | ZIP code of the ship-from address |
from_state | string | No | — | Two-letter state code of the ship-from address |
from_city | string | No | — | City of the ship-from address |
from_street | string | No | — | Street address of the ship-from address |
to_country | string | Yes | — | Two-letter ISO country code of the ship-to address |
to_zip | string | Yes | — | ZIP code of the ship-to address |
to_state | string | Yes | — | Two-letter state code of the ship-to address |
to_city | string | No | — | City of the ship-to address |
to_street | string | No | — | Street address of the ship-to address |
amount | number | No | — | Total amount of the order (excluding shipping). If line_items are provided, amount may be omitted. |
shipping | number | Yes | — | Total shipping cost for the order |
customer_id | string | No | — | Unique customer identifier for exemption matching |
exemption_type | string | No | — | Type of exemption |
nexus_addresses | object[] | No | — | Array of nexus address objects with id, country, state, zip |
line_items | object[] | No | — | Array of line item objects with id, quantity, product_tax_code, unit_price, discount |
taxjar_create_customer
Create a customer with a tax exemption profile. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
customer_id | string | Yes | — | Unique identifier for the customer |
exemption_type | string | Yes | — | Type of tax exemption |
name | string | Yes | — | Customer name |
exempt_regions | object[] | No | — | Array of exempt region objects with country and state |
country | string | No | — | Two-letter ISO country code |
state | string | No | — | Two-letter state code |
zip | string | No | — | ZIP code |
city | string | No | — | City name |
street | string | No | — | Street address |
taxjar_create_order_transaction
Create an order transaction for tax reporting. Records a completed order in TaxJar. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
transaction_id | string | Yes | — | Unique identifier of the order transaction |
transaction_date | string | Yes | — | Date of the transaction (YYYY-MM-DD or ISO 8601) |
from_country | string | No | — | Two-letter ISO country code of the ship-from address |
from_zip | string | No | — | ZIP code of the ship-from address |
from_state | string | No | — | Two-letter state code of the ship-from address |
from_city | string | No | — | City of the ship-from address |
from_street | string | No | — | Street address of the ship-from address |
to_country | string | Yes | — | Two-letter ISO country code of the ship-to address |
to_zip | string | Yes | — | ZIP code of the ship-to address |
to_state | string | Yes | — | Two-letter state code of the ship-to address |
to_city | string | No | — | City of the ship-to address |
to_street | string | No | — | Street address of the ship-to address |
amount | number | Yes | — | Total amount of the order (excluding shipping) |
shipping | number | Yes | — | Total shipping cost |
sales_tax | number | Yes | — | Total sales tax collected |
customer_id | string | No | — | Unique customer identifier |
exemption_type | string | No | — | Type of exemption |
line_items | object[] | No | — | Array of line item objects with id, quantity, product_identifier, description, unit_price, discount, sales_tax |
taxjar_create_refund_transaction
Create a refund transaction for tax reporting. Records a completed refund in TaxJar. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
transaction_id | string | Yes | — | Unique identifier of the refund transaction |
transaction_reference_id | string | Yes | — | Identifier of the original order transaction being refunded |
transaction_date | string | Yes | — | Date of the refund transaction (YYYY-MM-DD or ISO 8601) |
from_country | string | No | — | Two-letter ISO country code of the ship-from address |
from_zip | string | No | — | ZIP code of the ship-from address |
from_state | string | No | — | Two-letter state code of the ship-from address |
from_city | string | No | — | City of the ship-from address |
from_street | string | No | — | Street address of the ship-from address |
to_country | string | Yes | — | Two-letter ISO country code of the ship-to address |
to_zip | string | Yes | — | ZIP code of the ship-to address |
to_state | string | Yes | — | Two-letter state code of the ship-to address |
to_city | string | No | — | City of the ship-to address |
to_street | string | No | — | Street address of the ship-to address |
amount | number | Yes | — | Total refund amount (excluding shipping, negative values allowed) |
shipping | number | Yes | — | Shipping refund amount |
sales_tax | number | Yes | — | Sales tax refund amount |
customer_id | string | No | — | Unique customer identifier |
exemption_type | string | No | — | Type of exemption |
line_items | object[] | No | — | Array of line item objects with id, quantity, product_identifier, description, unit_price, discount, sales_tax |
taxjar_delete_order_transaction
Delete an existing order transaction by transaction ID. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
transaction_id | string | Yes | — | Unique identifier of the order transaction to delete |
taxjar_delete_refund_transaction
Delete an existing refund transaction by transaction ID. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
transaction_id | string | Yes | — | Unique identifier of the refund transaction to delete |
taxjar_list_categories
List all TaxJar product tax categories. Returns categories with their name, description, and product_tax_code for use in tax calculations.taxjar_list_customers
List customers with tax exemption profiles.taxjar_list_order_transactions
List order transactions. Optionally filter by date range, provider, or transaction source. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
transaction_date | string | No | — | Filter by exact transaction date (YYYY-MM-DD) |
from_transaction_date | string | No | — | Start of transaction date range (YYYY-MM-DD) |
to_transaction_date | string | No | — | End of transaction date range (YYYY-MM-DD) |
provider | string | No | — | Filter by provider (e.g. api) |
taxjar_list_refund_transactions
List refund transactions. Optionally filter by date range or provider. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
transaction_date | string | No | — | Filter by exact transaction date (YYYY-MM-DD) |
from_transaction_date | string | No | — | Start of transaction date range (YYYY-MM-DD) |
to_transaction_date | string | No | — | End of transaction date range (YYYY-MM-DD) |
provider | string | No | — | Filter by provider (e.g. api) |
taxjar_list_summary_rates
List minimum and average tax rates by region. Returns tax rate summaries for all US states and territories.taxjar_show_customer
Show details of a specific customer and their tax exemption profile. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
customer_id | string | Yes | — | Unique identifier of the customer |
taxjar_show_order_transaction
Show details of a specific order transaction by transaction ID. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
transaction_id | string | Yes | — | Unique identifier of the order transaction |
taxjar_show_refund_transaction
Show details of a specific refund transaction by transaction ID. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
transaction_id | string | Yes | — | Unique identifier of the refund transaction |
taxjar_show_tax_rates
Show tax rates for a specific location by ZIP code. Optionally provide city, state, and country for more accurate results. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
zip | string | Yes | — | ZIP code to look up tax rates for |
country | string | No | — | Two-letter ISO country code (default US) |
state | string | No | — | Two-letter state code |
city | string | No | — | City name for more accurate rates |
street | string | No | — | Street address for rooftop-level accuracy |
taxjar_update_order_transaction
Update an existing order transaction. All fields are optional except transaction_id. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
transaction_id | string | Yes | — | Unique identifier of the order transaction to update |
transaction_date | string | No | — | Date of the transaction (YYYY-MM-DD or ISO 8601) |
from_country | string | No | — | Two-letter ISO country code of the ship-from address |
from_zip | string | No | — | ZIP code of the ship-from address |
from_state | string | No | — | Two-letter state code of the ship-from address |
from_city | string | No | — | City of the ship-from address |
from_street | string | No | — | Street address of the ship-from address |
to_country | string | No | — | Two-letter ISO country code of the ship-to address |
to_zip | string | No | — | ZIP code of the ship-to address |
to_state | string | No | — | Two-letter state code of the ship-to address |
to_city | string | No | — | City of the ship-to address |
to_street | string | No | — | Street address of the ship-to address |
amount | number | No | — | Total amount of the order (excluding shipping) |
shipping | number | No | — | Total shipping cost |
sales_tax | number | No | — | Total sales tax collected |
customer_id | string | No | — | Unique customer identifier |
exemption_type | string | No | — | Type of exemption |
line_items | object[] | No | — | Array of line item objects with id, quantity, product_identifier, description, unit_price, discount, sales_tax |
taxjar_update_refund_transaction
Update an existing refund transaction. All fields are optional except transaction_id. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
transaction_id | string | Yes | — | Unique identifier of the refund transaction to update |
transaction_reference_id | string | No | — | Identifier of the original order transaction being refunded |
transaction_date | string | No | — | Date of the refund transaction (YYYY-MM-DD or ISO 8601) |
from_country | string | No | — | Two-letter ISO country code of the ship-from address |
from_zip | string | No | — | ZIP code of the ship-from address |
from_state | string | No | — | Two-letter state code of the ship-from address |
from_city | string | No | — | City of the ship-from address |
from_street | string | No | — | Street address of the ship-from address |
to_country | string | No | — | Two-letter ISO country code of the ship-to address |
to_zip | string | No | — | ZIP code of the ship-to address |
to_state | string | No | — | Two-letter state code of the ship-to address |
to_city | string | No | — | City of the ship-to address |
to_street | string | No | — | Street address of the ship-to address |
amount | number | No | — | Total refund amount (excluding shipping) |
shipping | number | No | — | Shipping refund amount |
sales_tax | number | No | — | Sales tax refund amount |
customer_id | string | No | — | Unique customer identifier |
exemption_type | string | No | — | Type of exemption |
line_items | object[] | No | — | Array of line item objects with id, quantity, product_identifier, description, unit_price, discount, sales_tax |
taxjar_validate_address
Validate a shipping address. Returns a validated and standardized version of the address. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
country | string | Yes | — | Two-letter ISO country code (currently only US supported) |
state | string | Yes | — | Two-letter state code |
zip | string | Yes | — | ZIP code |
city | string | No | — | City name |
street | string | No | — | Street address |

