You are viewing an old version of the API
Update item taxes

Updates the CatalogTax objects that apply to the targeted CatalogItem without having to perform an upsert on the entire item.

Required permissions ITEMS_WRITE

Request Body

Name Description
item_ids
string [ ]

Required

IDs for the CatalogItems associated with the CatalogTax objects being updated.

taxes_to_enable
string [ ]

IDs of the CatalogTax objects to enable.

taxes_to_disable
string [ ]

IDs of the CatalogTax objects to disable.

Response Fields

Name Description
errors
Error [ ]

Information on any errors encountered.

updated_at
string

The database timestamp of this update in RFC 3339 format, e.g., 2016-09-04T23:59:33.123Z.

Examples for January 25th, 2020 6:27.34pm Pacific Standard Time:

UTC: 2020-01-26T02:25:34Z

Pacific Standard Time with UTC offset: 2020-01-25T18:25:34-08:00

Examples

You are viewing an old version of the API
POST /v2/catalog/update-item-taxes
cURL
  • cURL
  • Ruby
  • Python
  • C#
  • Java
curl https://connect.squareup.com/v2/catalog/update-item-taxes \
  -X POST \
  -H 'Square-Version: 2020-03-25' \
  -H 'Authorization: Bearer ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "item_ids": [
      "H42BRLUJ5KTZTTMPVSLFAACQ",
      "2JXOBJIHCWBQ4NZ3RIXQGJA6"
    ],
    "taxes_to_enable": [
      "4WRCNHCJZDVLSNDQ35PP6YAD"
    ],
    "taxes_to_disable": [
      "AQCEGCEBBQONINDOHRGZISEX"
    ]
  }'
Response JSON
{
  "updated_at": "2016-11-16T22:25:24.878Z"
}

Share Feedback

Thanks for visiting the Square API documentation. What's on your mind?