> This page is for Developer.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.bigcommerce.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.bigcommerce.com/_mcp/server.

# Tax Customers

The Tax Customers API allows merchants to configure customer-specific tax data for use in tax calculations. This enables merchants to provide tax providers with additional customer-related information that may affect tax rates or exemptions.

This guide demonstrates how to use the Tax Customers API. For more, see the [Tax Customers API Reference](/developer/api-reference/rest/admin/management/tax/tax-customers).

## Tax customers

Tax customers rely on `customer_id` to associate tax data with specific customers. This data is sent to tax providers during tax calculations. The examples below demonstrate how to create, update, retrieve, and delete tax customer data.

### Get tax customers

To retrieve a list of tax customers, send a request to the [Get Tax Customers](/developer/api-reference/rest/admin/management/tax/tax-customers/get-tax-customers) endpoint. You can filter the results by specifying one or more `customer_id` values.

#### Request

**`Example request: Get tax customers`**

```http title="Example request: Get tax customers"
GET https://api.bigcommerce.com/stores/{{STORE_HASH}}/v3/tax/customers?customer_id:in=157,158
X-Auth-Token: {{ACCESS_TOKEN}}
Content-Type: application/json
Accept: application/json
```

#### Response

**`Example response: Get tax customers`**

```json title="Example response: Get tax customers"
{
  "data": [
    {
      "customer_id": 157,
      "tax_properties": {
        "A-123456789": "26",
        "B-6731789": "200"
      }
    },
    {
      "customer_id": 158,
      "tax_properties": {
        "A-123456789": "15"
      }
    }
  ],
  "meta": {
    "pagination": {
      "total": 2,
      "count": 2,
      "per_page": 50,
      "current_page": 1,
      "total_pages": 1,
      "links": {
        "current": "?customer_id%3Ain=157%2C158&page=1&limit=50"
      }
    }
  }
}
```

### Update tax customers

To add or update tax data for one or more customers, send a request to the [Update Tax Customers](/developer/api-reference/rest/admin/management/tax/tax-customers/update-tax-customers) endpoint. This operation overwrites any existing values for the specified customers.

#### Request

**`Example request: Update tax customers`**

```http title="Example request: Update tax customers"
PUT https://api.bigcommerce.com/stores/{{STORE_HASH}}/v3/tax/customers
X-Auth-Token: {{ACCESS_TOKEN}}
Content-Type: application/json
Accept: application/json

[
  {
    "customer_id": 157,
    "tax_properties": {
      "A-123456789": "30",
      "B-6731789": "250"
    }
  },
  {
    "customer_id": 159,
    "tax_properties": {
      "A-123456789": "10"
    }
  }
]
```

#### Response

**`Example response: Update tax customers`**

```json title="Example response: Update tax customers"
{
  "data": [
    {
      "customer_id": 157,
      "tax_properties": {
        "A-123456789": "30",
        "B-6731789": "250"
      }
    },
    {
      "customer_id": 159,
      "tax_properties": {
        "A-123456789": "10"
      }
    }
  ],
  "meta": {}
}
```

### Delete tax customers

To delete tax data associated with one or more customers, send a request to the [Delete Tax Customers](/developer/api-reference/rest/admin/management/tax/tax-customers/delete-tax-customers) endpoint. Use the `customer_id:in` query parameter to specify the customers whose tax data you want to delete.

> **Note**
>
> #### Batch deletion
>
> This operation removes **all** tax properties associated with the specified customers.

#### Request

**`Example request: Delete tax customers`**

```http title="Example request: Delete tax customers"
DELETE https://api.bigcommerce.com/stores/{{STORE_HASH}}/v3/tax/customers?customer_id:in=157
X-Auth-Token: {{ACCESS_TOKEN}}
Content-Type: application/json
Accept: application/json
```

#### Response

**`Example response: Delete tax customers`**

```http title="Example response: Delete tax customers"
HTTP 204 No content
```

## Resources

* [Tax Customers API Reference](/developer/api-reference/rest/admin/management/tax/tax-customers)
* [Tax Properties API Reference](/developer/api-reference/rest/admin/management/tax/tax-properties)
* [Tax Provider API Reference](/developer/docs/integrations/tax-providers)