# Taxjar

TaxJar provides a comprehensive sales tax API for real-time tax calculations, reporting, and filing.

- **Category:** taxes
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 21
- **Triggers:** 0
- **Slug:** `TAXJAR`
- **Version:** 20260223_00

## Tools

### Calculate Sales Tax For An Order

**Slug:** `TAXJAR_CALCULATE_SALES_TAX_FOR_AN_ORDER`

Tool to calculate sales tax for an order. Use when you need an accurate tax calculation including nexus addresses, line items, shipping, and exemptions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `amount` | number | Yes | Order amount (excluding shipping) |
| `to_zip` | string | Yes | Destination ZIP or postal code |
| `to_city` | string | No | Destination city |
| `from_zip` | string | Yes | Origin ZIP or postal code |
| `shipping` | number | Yes | Shipping cost for the order |
| `to_state` | string | Yes | Destination state or province |
| `from_city` | string | No | Origin city |
| `to_street` | string | No | Destination street address |
| `from_state` | string | Yes | Origin state or province |
| `line_items` | array | No | List of line items in the order |
| `to_country` | string | Yes | Destination country code (ISO 3166-1 alpha-2) |
| `customer_id` | string | No | Identifier for the customer, if known |
| `from_street` | string | No | Origin street address |
| `from_country` | string | Yes | Origin country code (ISO 3166-1 alpha-2) |
| `exemption_type` | string | No | Type of exemption for the order (e.g., wholesale, government, non_profit, other) |
| `nexus_addresses` | array | No | List of seller nexus addresses to consider for tax calculations |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Customer

**Slug:** `TAXJAR_CREATE_CUSTOMER`

Tool 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

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Order Transaction

**Slug:** `TAXJAR_CREATE_ORDER_TRANSACTION`

Creates a new order transaction in TaxJar for sales tax reporting and compliance. This action records order transactions that will appear in the TaxJar dashboard for tax filing purposes. The transaction includes customer location, order amounts, shipping costs, and sales tax collected. Important: The 'amount' field must include shipping but exclude sales tax. If line_items are provided, their sum (quantity * unit_price - discount) must equal amount minus shipping.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `amount` | number | Yes | 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. |
| `to_lat` | number | No | Latitude of the destination address |
| `to_lng` | number | No | Longitude of the destination address |
| `to_zip` | string | Yes | Postal code of the order destination |
| `to_city` | string | No | City of the order destination |
| `user_id` | string | No | Identifier of the user associated with the transaction |
| `shipping` | number | Yes | Total shipping amount for the order |
| `to_state` | string | Yes | Two-letter state code for the order destination |
| `sales_tax` | number | No | Sales tax collected for the order |
| `to_street` | string | No | Street address of the order destination |
| `line_items` | array | No | Line items in the order. If provided, sum of (quantity * unit_price - discount) must equal amount minus shipping. |
| `to_country` | string | Yes | Two-letter ISO country code of the order destination |
| `exemption_type` | string ("wholesale" | "government" | "marketplace" | "other" | "non_exempt") | No | Type of exemption if applicable. Must be 'non_exempt' or 'marketplace' if sales_tax is non-zero. |
| `transaction_id` | string | Yes | Unique identifier for the transaction |
| `nexus_addresses` | array | No | Nexus addresses associated with the transaction |
| `transaction_date` | string | Yes | Date/time when transaction occurred (ISO 8601 format) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Refund Transaction

**Slug:** `TAXJAR_CREATE_REFUND_TRANSACTION`

Tool to create a new refund transaction. Use after confirming refund details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `amount` | number | Yes | Total amount refunded (negative value, excluding shipping & tax) |
| `to_zip` | string | Yes | Postal code of refund destination |
| `to_city` | string | No | City of refund destination |
| `provider` | string | No | E-commerce provider for the transaction |
| `shipping` | number | No | Total shipping refunded (negative for refund) |
| `to_state` | string | Yes | Two-letter state code for the refund destination |
| `sales_tax` | number | No | Total sales tax refunded (negative for refund) |
| `to_street` | string | No | Street address of refund destination |
| `line_items` | array | No | Line items detail for the refunded transaction |
| `to_country` | string | Yes | Two-letter ISO country code of refund destination |
| `transaction_id` | string | Yes | Unique identifier for the refund transaction |
| `transaction_date` | string | Yes | Date/time when refund occurred (ISO 8601 format) |
| `transaction_reference_id` | string | Yes | Identifier of the original order being refunded |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Customer

**Slug:** `TAXJAR_DELETE_CUSTOMER`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `customer_id` | string | Yes | Unique identifier of the customer to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Order Transaction

**Slug:** `TAXJAR_DELETE_ORDER_TRANSACTION`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `transaction_id` | string | Yes | Unique identifier of the order transaction to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Refund Transaction

**Slug:** `TAXJAR_DELETE_REFUND_TRANSACTION`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `transaction_id` | string | Yes | Unique identifier of the refund transaction to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Customers

**Slug:** `TAXJAR_LIST_CUSTOMERS`

Lists all customer IDs from your TaxJar account. Returns a paginated list of customer IDs (strings). To get full details for a specific customer (including name, address, exemption type, etc.), use the customer ID with the 'Show Customer' action. Use this action to: - Browse all customers in your TaxJar account - Find customer IDs for further operations - Check which customers have been created

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination, starting at 1. Use this to navigate through multiple pages of customers. |
| `per_page` | integer | No | Maximum number of customer IDs to return per page. Must be between 1 and 100. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Nexus Regions

**Slug:** `TAXJAR_LIST_NEXUS_REGIONS`

Tool to list existing nexus regions for an account. Use after authenticating your account to discover where you have nexus for sales tax purposes.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Order Transactions

**Slug:** `TAXJAR_LIST_ORDER_TRANSACTIONS`

List 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `provider` | string | No | Filter by provider source, e.g., 'api' or 'csv'. Defaults to 'api' if not specified. |
| `to_transaction_date` | string | Yes | End date for filtering order transactions (YYYY-MM-DD or YYYY/MM/DD). Required parameter. |
| `from_transaction_date` | string | Yes | Start date for filtering order transactions (YYYY-MM-DD or YYYY/MM/DD). Required parameter. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List refund transactions

**Slug:** `TAXJAR_LIST_REFUND_TRANSACTIONS`

Lists 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `provider` | string | No | Filter by provider source (e.g., 'api', 'csv') |
| `to_transaction_date` | string | Yes | End date for filtering refund transactions (format: YYYY/MM/DD or YYYY-MM-DD) |
| `from_transaction_date` | string | Yes | Start date for filtering refund transactions (format: YYYY/MM/DD or YYYY-MM-DD) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Tax Categories

**Slug:** `TAXJAR_LIST_TAX_CATEGORIES`

Tool to list all product tax categories and their codes. Use when you need to discover available tax categories before assigning them to products.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Show Customer

**Slug:** `TAXJAR_SHOW_CUSTOMER`

Tool to show an existing customer. Use when you need to retrieve details of a specific customer via TaxJar API.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `customer_id` | string | Yes | Unique identifier for the customer |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Show Order Transaction

**Slug:** `TAXJAR_SHOW_ORDER_TRANSACTION`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `transaction_id` | string | Yes | The unique identifier for the order transaction |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Show Refund Transaction

**Slug:** `TAXJAR_SHOW_REFUND_TRANSACTION`

Retrieves 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `transaction_id` | string | Yes | The unique ID of the refund transaction to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Show Tax Rates for a Location

**Slug:** `TAXJAR_SHOW_TAX_RATES_FOR_A_LOCATION`

Tool to show sales tax rates for a location. Use when you need to retrieve sales tax rates for a specific ZIP code with optional address details (city, state, country, street).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `zip` | string | Yes | ZIP code to retrieve rates for |
| `city` | string | No | City name |
| `state` | string | No | State abbreviation |
| `street` | string | No | Street address |
| `country` | string | No | Two-letter country code (ISO-2), default 'US' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Summarize Tax Rates for All Regions

**Slug:** `TAXJAR_SUMMARIZE_TAX_RATES_FOR_ALL_REGIONS`

Tool to retrieve minimum and average sales tax rates by region. Use when you need a backup of regional tax summary rates.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Customer

**Slug:** `TAXJAR_UPDATE_CUSTOMER`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `zip` | string | No | Postal code |
| `city` | string | No | City |
| `name` | string | Yes | Customer name |
| `state` | string | No | Two-letter ISO state code |
| `street` | string | No | Street address |
| `country` | string | No | Two-letter ISO country code |
| `customer_id` | string | Yes | Unique identifier of the customer to update |
| `exempt_regions` | array | No | Regions where the customer is exempt from sales tax |
| `exemption_type` | string ("wholesale" | "government" | "marketplace" | "other" | "non_exempt") | Yes | Type of exemption for the customer (wholesale, government, marketplace, other, or non_exempt) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Order Transaction

**Slug:** `TAXJAR_UPDATE_ORDER_TRANSACTION`

Tool to update an existing order transaction. Use when adjusting order details such as amount, shipping, or line items after creation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `amount` | number | No | Total amount of the order |
| `to_zip` | string | No | Postal code of the order destination |
| `to_city` | string | No | City of the order destination |
| `provider` | string | No | Transaction provider, e.g., 'api', 'csv' |
| `shipping` | number | No | Total shipping amount for the order |
| `to_state` | string | No | Two-letter state code for the order destination |
| `sales_tax` | number | No | Sales tax collected for the order |
| `to_street` | string | No | Street address of the order destination |
| `line_items` | array | No | Line items in the order |
| `to_country` | string | No | Two-letter ISO country code of the order destination |
| `transaction_id` | string | Yes | Unique identifier for the transaction to update |
| `transaction_date` | string | No | Date/time when transaction occurred (ISO 8601 format) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Refund Transaction

**Slug:** `TAXJAR_UPDATE_REFUND_TRANSACTION`

Tool to update an existing refund transaction. Use when adjusting refund details such as amount, shipping, or line items after creation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `amount` | number | No | Total amount of the refund excluding shipping |
| `to_zip` | string | No | Postal code of destination |
| `to_city` | string | No | City of destination |
| `from_zip` | string | No | Postal code of origin |
| `shipping` | number | No | Total amount of shipping refunded |
| `to_state` | string | No | Two-letter ISO state code of destination |
| `from_city` | string | No | City of origin |
| `sales_tax` | number | No | Total amount of sales tax refunded |
| `to_street` | string | No | Street address of destination |
| `from_state` | string | No | Two-letter ISO state code of origin |
| `line_items` | array | No | Line items for the refund |
| `to_country` | string | No | Two-letter ISO country code of destination |
| `customer_id` | string | No | Unique identifier of the customer |
| `from_street` | string | No | Street address of origin |
| `from_country` | string | No | Two-letter ISO country code of origin |
| `exemption_type` | string ("wholesale" | "government" | "marketplace" | "other" | "non_exempt") | No | Type of exemption for the refund |
| `transaction_id` | string | Yes | Unique identifier for the refund transaction to update |
| `transaction_date` | string | No | Date the transaction was recorded (YYYY-MM-DD format) |
| `transaction_reference_id` | string | No | Unique identifier of the original order transaction |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Validate VAT Number

**Slug:** `TAXJAR_VALIDATE_VAT_NUMBER`

Validates 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `vat_number` | string | Yes | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |