> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# taxjar

> TaxJar Sales Tax API

**Server path:** `/taxjar` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                                    | Description                                                                                                                                  |
| ----------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| [`taxjar_calculate_tax`](#taxjar_calculate_tax)                         | Calculate the sales tax for a given order. Requires shipping destination and at least one line item.                                         |
| [`taxjar_create_customer`](#taxjar_create_customer)                     | Create a customer with a tax exemption profile.                                                                                              |
| [`taxjar_create_order_transaction`](#taxjar_create_order_transaction)   | Create an order transaction for tax reporting. Records a completed order in TaxJar.                                                          |
| [`taxjar_create_refund_transaction`](#taxjar_create_refund_transaction) | Create a refund transaction for tax reporting. Records a completed refund in TaxJar.                                                         |
| [`taxjar_delete_order_transaction`](#taxjar_delete_order_transaction)   | Delete an existing order transaction by transaction ID.                                                                                      |
| [`taxjar_delete_refund_transaction`](#taxjar_delete_refund_transaction) | Delete an existing refund transaction by transaction ID.                                                                                     |
| [`taxjar_list_categories`](#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`](#taxjar_list_customers)                       | List customers with tax exemption profiles.                                                                                                  |
| [`taxjar_list_order_transactions`](#taxjar_list_order_transactions)     | List order transactions. Optionally filter by date range, provider, or transaction source.                                                   |
| [`taxjar_list_refund_transactions`](#taxjar_list_refund_transactions)   | List refund transactions. Optionally filter by date range or provider.                                                                       |
| [`taxjar_list_summary_rates`](#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`](#taxjar_show_customer)                         | Show details of a specific customer and their tax exemption profile.                                                                         |
| [`taxjar_show_order_transaction`](#taxjar_show_order_transaction)       | Show details of a specific order transaction by transaction ID.                                                                              |
| [`taxjar_show_refund_transaction`](#taxjar_show_refund_transaction)     | Show details of a specific refund transaction by transaction ID.                                                                             |
| [`taxjar_show_tax_rates`](#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`](#taxjar_update_order_transaction)   | Update an existing order transaction. All fields are optional except transaction\_id.                                                        |
| [`taxjar_update_refund_transaction`](#taxjar_update_refund_transaction) | Update an existing refund transaction. All fields are optional except transaction\_id.                                                       |
| [`taxjar_validate_address`](#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             |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "from_country": {
        "type": "string",
        "description": "Two-letter ISO country code of the ship-from address"
      },
      "from_zip": {
        "type": "string",
        "description": "ZIP code of the ship-from address"
      },
      "from_state": {
        "type": "string",
        "description": "Two-letter state code of the ship-from address"
      },
      "from_city": {
        "type": "string",
        "description": "City of the ship-from address"
      },
      "from_street": {
        "type": "string",
        "description": "Street address of the ship-from address"
      },
      "to_country": {
        "type": "string",
        "description": "Two-letter ISO country code of the ship-to address"
      },
      "to_zip": {
        "type": "string",
        "description": "ZIP code of the ship-to address"
      },
      "to_state": {
        "type": "string",
        "description": "Two-letter state code of the ship-to address"
      },
      "to_city": {
        "type": "string",
        "description": "City of the ship-to address"
      },
      "to_street": {
        "type": "string",
        "description": "Street address of the ship-to address"
      },
      "amount": {
        "type": "number",
        "description": "Total amount of the order (excluding shipping). If line_items are provided, amount may be omitted."
      },
      "shipping": {
        "type": "number",
        "description": "Total shipping cost for the order"
      },
      "customer_id": {
        "type": "string",
        "description": "Unique customer identifier for exemption matching"
      },
      "exemption_type": {
        "type": "string",
        "description": "Type of exemption",
        "enum": [
          "wholesale",
          "government",
          "marketplace",
          "other",
          "non_exempt"
        ]
      },
      "nexus_addresses": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Array of nexus address objects with id, country, state, zip"
      },
      "line_items": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Array of line item objects with id, quantity, product_tax_code, unit_price, discount"
      }
    },
    "required": [
      "PCID",
      "to_country",
      "to_zip",
      "to_state",
      "shipping"
    ]
  }
  ```
</Expandable>

***

## 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                                        |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "customer_id": {
        "type": "string",
        "description": "Unique identifier for the customer"
      },
      "exemption_type": {
        "type": "string",
        "description": "Type of tax exemption",
        "enum": [
          "wholesale",
          "government",
          "marketplace",
          "other",
          "non_exempt"
        ]
      },
      "name": {
        "type": "string",
        "description": "Customer name"
      },
      "exempt_regions": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Array of exempt region objects with country and state"
      },
      "country": {
        "type": "string",
        "description": "Two-letter ISO country code"
      },
      "state": {
        "type": "string",
        "description": "Two-letter state code"
      },
      "zip": {
        "type": "string",
        "description": "ZIP code"
      },
      "city": {
        "type": "string",
        "description": "City name"
      },
      "street": {
        "type": "string",
        "description": "Street address"
      }
    },
    "required": [
      "PCID",
      "customer_id",
      "exemption_type",
      "name"
    ]
  }
  ```
</Expandable>

***

## 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 |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "transaction_id": {
        "type": "string",
        "description": "Unique identifier of the order transaction"
      },
      "transaction_date": {
        "type": "string",
        "description": "Date of the transaction (YYYY-MM-DD or ISO 8601)"
      },
      "from_country": {
        "type": "string",
        "description": "Two-letter ISO country code of the ship-from address"
      },
      "from_zip": {
        "type": "string",
        "description": "ZIP code of the ship-from address"
      },
      "from_state": {
        "type": "string",
        "description": "Two-letter state code of the ship-from address"
      },
      "from_city": {
        "type": "string",
        "description": "City of the ship-from address"
      },
      "from_street": {
        "type": "string",
        "description": "Street address of the ship-from address"
      },
      "to_country": {
        "type": "string",
        "description": "Two-letter ISO country code of the ship-to address"
      },
      "to_zip": {
        "type": "string",
        "description": "ZIP code of the ship-to address"
      },
      "to_state": {
        "type": "string",
        "description": "Two-letter state code of the ship-to address"
      },
      "to_city": {
        "type": "string",
        "description": "City of the ship-to address"
      },
      "to_street": {
        "type": "string",
        "description": "Street address of the ship-to address"
      },
      "amount": {
        "type": "number",
        "description": "Total amount of the order (excluding shipping)"
      },
      "shipping": {
        "type": "number",
        "description": "Total shipping cost"
      },
      "sales_tax": {
        "type": "number",
        "description": "Total sales tax collected"
      },
      "customer_id": {
        "type": "string",
        "description": "Unique customer identifier"
      },
      "exemption_type": {
        "type": "string",
        "description": "Type of exemption",
        "enum": [
          "wholesale",
          "government",
          "marketplace",
          "other",
          "non_exempt"
        ]
      },
      "line_items": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Array of line item objects with id, quantity, product_identifier, description, unit_price, discount, sales_tax"
      }
    },
    "required": [
      "PCID",
      "transaction_id",
      "transaction_date",
      "to_country",
      "to_state",
      "to_zip",
      "amount",
      "shipping",
      "sales_tax"
    ]
  }
  ```
</Expandable>

***

## 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 |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "transaction_id": {
        "type": "string",
        "description": "Unique identifier of the refund transaction"
      },
      "transaction_reference_id": {
        "type": "string",
        "description": "Identifier of the original order transaction being refunded"
      },
      "transaction_date": {
        "type": "string",
        "description": "Date of the refund transaction (YYYY-MM-DD or ISO 8601)"
      },
      "from_country": {
        "type": "string",
        "description": "Two-letter ISO country code of the ship-from address"
      },
      "from_zip": {
        "type": "string",
        "description": "ZIP code of the ship-from address"
      },
      "from_state": {
        "type": "string",
        "description": "Two-letter state code of the ship-from address"
      },
      "from_city": {
        "type": "string",
        "description": "City of the ship-from address"
      },
      "from_street": {
        "type": "string",
        "description": "Street address of the ship-from address"
      },
      "to_country": {
        "type": "string",
        "description": "Two-letter ISO country code of the ship-to address"
      },
      "to_zip": {
        "type": "string",
        "description": "ZIP code of the ship-to address"
      },
      "to_state": {
        "type": "string",
        "description": "Two-letter state code of the ship-to address"
      },
      "to_city": {
        "type": "string",
        "description": "City of the ship-to address"
      },
      "to_street": {
        "type": "string",
        "description": "Street address of the ship-to address"
      },
      "amount": {
        "type": "number",
        "description": "Total refund amount (excluding shipping, negative values allowed)"
      },
      "shipping": {
        "type": "number",
        "description": "Shipping refund amount"
      },
      "sales_tax": {
        "type": "number",
        "description": "Sales tax refund amount"
      },
      "customer_id": {
        "type": "string",
        "description": "Unique customer identifier"
      },
      "exemption_type": {
        "type": "string",
        "description": "Type of exemption",
        "enum": [
          "wholesale",
          "government",
          "marketplace",
          "other",
          "non_exempt"
        ]
      },
      "line_items": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Array of line item objects with id, quantity, product_identifier, description, unit_price, discount, sales_tax"
      }
    },
    "required": [
      "PCID",
      "transaction_id",
      "transaction_reference_id",
      "transaction_date",
      "to_country",
      "to_state",
      "to_zip",
      "amount",
      "shipping",
      "sales_tax"
    ]
  }
  ```
</Expandable>

***

## 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 |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "transaction_id": {
        "type": "string",
        "description": "Unique identifier of the order transaction to delete"
      }
    },
    "required": [
      "PCID",
      "transaction_id"
    ]
  }
  ```
</Expandable>

***

## 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 |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "transaction_id": {
        "type": "string",
        "description": "Unique identifier of the refund transaction to delete"
      }
    },
    "required": [
      "PCID",
      "transaction_id"
    ]
  }
  ```
</Expandable>

***

## taxjar\_list\_categories

List all TaxJar product tax categories. Returns categories with their name, description, and product\_tax\_code for use in tax calculations.

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## taxjar\_list\_customers

List customers with tax exemption profiles.

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## 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)                 |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "transaction_date": {
        "type": "string",
        "description": "Filter by exact transaction date (YYYY-MM-DD)"
      },
      "from_transaction_date": {
        "type": "string",
        "description": "Start of transaction date range (YYYY-MM-DD)"
      },
      "to_transaction_date": {
        "type": "string",
        "description": "End of transaction date range (YYYY-MM-DD)"
      },
      "provider": {
        "type": "string",
        "description": "Filter by provider (e.g. api)"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## 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)                 |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "transaction_date": {
        "type": "string",
        "description": "Filter by exact transaction date (YYYY-MM-DD)"
      },
      "from_transaction_date": {
        "type": "string",
        "description": "Start of transaction date range (YYYY-MM-DD)"
      },
      "to_transaction_date": {
        "type": "string",
        "description": "End of transaction date range (YYYY-MM-DD)"
      },
      "provider": {
        "type": "string",
        "description": "Filter by provider (e.g. api)"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## taxjar\_list\_summary\_rates

List minimum and average tax rates by region. Returns tax rate summaries for all US states and territories.

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## 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 |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "customer_id": {
        "type": "string",
        "description": "Unique identifier of the customer"
      }
    },
    "required": [
      "PCID",
      "customer_id"
    ]
  }
  ```
</Expandable>

***

## 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 |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "transaction_id": {
        "type": "string",
        "description": "Unique identifier of the order transaction"
      }
    },
    "required": [
      "PCID",
      "transaction_id"
    ]
  }
  ```
</Expandable>

***

## 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 |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "transaction_id": {
        "type": "string",
        "description": "Unique identifier of the refund transaction"
      }
    },
    "required": [
      "PCID",
      "transaction_id"
    ]
  }
  ```
</Expandable>

***

## 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 |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "zip": {
        "type": "string",
        "description": "ZIP code to look up tax rates for"
      },
      "country": {
        "type": "string",
        "description": "Two-letter ISO country code (default US)"
      },
      "state": {
        "type": "string",
        "description": "Two-letter state code"
      },
      "city": {
        "type": "string",
        "description": "City name for more accurate rates"
      },
      "street": {
        "type": "string",
        "description": "Street address for rooftop-level accuracy"
      }
    },
    "required": [
      "PCID",
      "zip"
    ]
  }
  ```
</Expandable>

***

## 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 |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "transaction_id": {
        "type": "string",
        "description": "Unique identifier of the order transaction to update"
      },
      "transaction_date": {
        "type": "string",
        "description": "Date of the transaction (YYYY-MM-DD or ISO 8601)"
      },
      "from_country": {
        "type": "string",
        "description": "Two-letter ISO country code of the ship-from address"
      },
      "from_zip": {
        "type": "string",
        "description": "ZIP code of the ship-from address"
      },
      "from_state": {
        "type": "string",
        "description": "Two-letter state code of the ship-from address"
      },
      "from_city": {
        "type": "string",
        "description": "City of the ship-from address"
      },
      "from_street": {
        "type": "string",
        "description": "Street address of the ship-from address"
      },
      "to_country": {
        "type": "string",
        "description": "Two-letter ISO country code of the ship-to address"
      },
      "to_zip": {
        "type": "string",
        "description": "ZIP code of the ship-to address"
      },
      "to_state": {
        "type": "string",
        "description": "Two-letter state code of the ship-to address"
      },
      "to_city": {
        "type": "string",
        "description": "City of the ship-to address"
      },
      "to_street": {
        "type": "string",
        "description": "Street address of the ship-to address"
      },
      "amount": {
        "type": "number",
        "description": "Total amount of the order (excluding shipping)"
      },
      "shipping": {
        "type": "number",
        "description": "Total shipping cost"
      },
      "sales_tax": {
        "type": "number",
        "description": "Total sales tax collected"
      },
      "customer_id": {
        "type": "string",
        "description": "Unique customer identifier"
      },
      "exemption_type": {
        "type": "string",
        "description": "Type of exemption",
        "enum": [
          "wholesale",
          "government",
          "marketplace",
          "other",
          "non_exempt"
        ]
      },
      "line_items": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Array of line item objects with id, quantity, product_identifier, description, unit_price, discount, sales_tax"
      }
    },
    "required": [
      "PCID",
      "transaction_id"
    ]
  }
  ```
</Expandable>

***

## 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 |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "transaction_id": {
        "type": "string",
        "description": "Unique identifier of the refund transaction to update"
      },
      "transaction_reference_id": {
        "type": "string",
        "description": "Identifier of the original order transaction being refunded"
      },
      "transaction_date": {
        "type": "string",
        "description": "Date of the refund transaction (YYYY-MM-DD or ISO 8601)"
      },
      "from_country": {
        "type": "string",
        "description": "Two-letter ISO country code of the ship-from address"
      },
      "from_zip": {
        "type": "string",
        "description": "ZIP code of the ship-from address"
      },
      "from_state": {
        "type": "string",
        "description": "Two-letter state code of the ship-from address"
      },
      "from_city": {
        "type": "string",
        "description": "City of the ship-from address"
      },
      "from_street": {
        "type": "string",
        "description": "Street address of the ship-from address"
      },
      "to_country": {
        "type": "string",
        "description": "Two-letter ISO country code of the ship-to address"
      },
      "to_zip": {
        "type": "string",
        "description": "ZIP code of the ship-to address"
      },
      "to_state": {
        "type": "string",
        "description": "Two-letter state code of the ship-to address"
      },
      "to_city": {
        "type": "string",
        "description": "City of the ship-to address"
      },
      "to_street": {
        "type": "string",
        "description": "Street address of the ship-to address"
      },
      "amount": {
        "type": "number",
        "description": "Total refund amount (excluding shipping)"
      },
      "shipping": {
        "type": "number",
        "description": "Shipping refund amount"
      },
      "sales_tax": {
        "type": "number",
        "description": "Sales tax refund amount"
      },
      "customer_id": {
        "type": "string",
        "description": "Unique customer identifier"
      },
      "exemption_type": {
        "type": "string",
        "description": "Type of exemption",
        "enum": [
          "wholesale",
          "government",
          "marketplace",
          "other",
          "non_exempt"
        ]
      },
      "line_items": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Array of line item objects with id, quantity, product_identifier, description, unit_price, discount, sales_tax"
      }
    },
    "required": [
      "PCID",
      "transaction_id"
    ]
  }
  ```
</Expandable>

***

## 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                                            |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "country": {
        "type": "string",
        "description": "Two-letter ISO country code (currently only US supported)"
      },
      "state": {
        "type": "string",
        "description": "Two-letter state code"
      },
      "zip": {
        "type": "string",
        "description": "ZIP code"
      },
      "city": {
        "type": "string",
        "description": "City name"
      },
      "street": {
        "type": "string",
        "description": "Street address"
      }
    },
    "required": [
      "PCID",
      "country",
      "state",
      "zip"
    ]
  }
  ```
</Expandable>