woocommerce-rest-api-docs/source/includes/wp-api-v3/_tax-classes.md

Tax classes

The tax classes API allows you to create, view, and delete individual tax classes.

Tax class properties

Attribute	Type	Description
slug	string	Unique identifier for the resource. read-only
name	string	Tax class name. required

Create a tax class

This API helps you to create a new tax class.

HTTP request

POST

/wp-json/wc/v3/taxes/classes

curl -X POST https://example.com/wp-json/wc/v3/taxes/classes \
    -u consumer_key:consumer_secret \
    -H "Content-Type: application/json" \
    -d '{
  "name": "Zero Rate"
}'

const data = {
  name: "Zero Rate"
};

WooCommerce.post("taxes/classes", data)
  .then((response) => {
    console.log(response.data);
  })
  .catch((error) => {
    console.log(error.response.data);
  });

<?php
$data = [
    'name' => 'Zero Rate'
];

print_r($woocommerce->post('taxes/classes', $data));
?>

data = {
    "name": "Zero Rate"
}

print(wcapi.post("taxes/classes", data).json())

data = {
  name: "Zero Rate"
}

woocommerce.post("taxes/classes", data).parsed_response

JSON response example:

{
  "slug": "zero-rate",
  "name": "Zero Rate",
  "_links": {
    "collection": [
      {
        "href": "https://example.com/wp-json/wc/v3/taxes/classes"
      }
    ]
  }
}

List all tax classes

This API helps you to view all tax classes.

HTTP request

GET

/wp-json/wc/v3/taxes/classes

curl https://example.com/wp-json/wc/v3/taxes/classes \
	-u consumer_key:consumer_secret

WooCommerce.get("taxes/classes")
  .then((response) => {
    console.log(response.data);
  })
  .catch((error) => {
    console.log(error.response.data);
  });

<?php print_r($woocommerce->get('taxes/classes')); ?>

print(wcapi.get("taxes/classes").json())

woocommerce.get("taxes/classes").parsed_response

JSON response example:

[
  {
    "slug": "standard",
    "name": "Standard Rate",
    "_links": {
      "collection": [
        {
          "href": "https://example.com/wp-json/wc/v3/taxes/classes"
        }
      ]
    }
  },
  {
    "slug": "reduced-rate",
    "name": "Reduced Rate",
    "_links": {
      "collection": [
        {
          "href": "https://example.com/wp-json/wc/v3/taxes/classes"
        }
      ]
    }
  },
  {
    "slug": "zero-rate",
    "name": "Zero Rate",
    "_links": {
      "collection": [
        {
          "href": "https://example.com/wp-json/wc/v3/taxes/classes"
        }
      ]
    }
  }
]

Delete a tax class

This API helps you delete a tax class.

This also will delete all tax rates from the selected class.

HTTP request

DELETE

/wp-json/wc/v3/taxes/classes/<slug>

curl -X DELETE https://example.com/wp-json/wc/v3/taxes/classes/zero-rate?force=true \
	-u consumer_key:consumer_secret

WooCommerce.delete("taxes/classes/zero-rate", {
  force: true
})
  .then((response) => {
    console.log(response.data);
  })
  .catch((error) => {
    console.log(error.response.data);
  });

<?php print_r($woocommerce->delete('taxes/classes/zero-rate', ['force' => true])); ?>

print(wcapi.delete("taxes/classes/zero-rate", params={"force": True}).json())

woocommerce.delete("taxes/classes/zero-rate", force: true).parsed_response

JSON response example:

{
  "slug": "zero-rate",
  "name": "Zero Rate",
  "_links": {
    "collection": [
      {
        "href": "https://example.com/wp-json/wc/v3/taxes/classes"
      }
    ]
  }
}

Available parameters

Parameter	Type	Description
force	string	Required to be true, since this resource does not support trashing.