GET v1/Companies({CompanyId})/TaxCategories

Returns all Tax Categories for a Company

Information:

Base URL:

https://api.covasoft.net/taxes

Example of a call would be:

https://api.covasoft.net/taxes/v1/Companies({CompanyId})/TaxCategories

Request Information

URI Parameters

Name	Description	Type	Additional information
CompanyId	The unique Company Id that was provided in your onboarding pacakage	integer	Required

Body Parameters

None.

Response Information

Resource Description

All the Tax Categories for a Company

Collection of TaxCategory

Name	Type	Additional information
Id	globally unique identifier	None.
CompanyId	integer	None.
Name	string	None.
Description	string	None.
IsDefault	boolean	None.
ProductCatalogIds	Collection of globally unique identifier	None.
TaxMapping	TaxMapping	None.

Response Formats

application/json, text/json

Sample:

[
  {
    "Id": "423e4366-75de-4ed8-838d-4efed7a6f3cf",
    "CompanyId": 2,
    "Name": "sample string 3",
    "Description": "sample string 4",
    "IsDefault": true,
    "ProductCatalogIds": [
      "a25be6e8-eb79-4c90-b90b-ae8963470334",
      "39eec48c-867e-4310-b583-b5994d837dd8"
    ],
    "TaxMapping": {
      "Id": "9b03ed41-31de-42b0-a476-8157cbc70b96",
      "CompanyId": 2,
      "TaxCategory": "sample string 3",
      "TaxCategoryId": "55d293cc-ec14-4fa8-8bc3-45504cacdc17",
      "CorrelationId": "06f5634e-fbca-4c17-8c94-d5439565fb8f",
      "TaxRateIds": [
        "2c87ad86-6d2d-41c3-97b0-4c9013b8eb23",
        "aa30ec0f-d79a-4ccc-b510-1d6e5addbb4d"
      ],
      "TaxRates": [
        {
          "Id": "80f61b22-95b1-4270-a257-55b520fc3195",
          "CompanyId": 2,
          "Name": "sample string 3",
          "DisplayName": "sample string 4",
          "Description": "sample string 5",
          "Rate": 6.1,
          "TaxRateType": "sample string 7",
          "TaxCalculatedOn": "sample string 8",
          "Layer": 9,
          "StartDateUtc": "2026-03-20T21:38:08.1093559+00:00",
          "EndDateUtc": "2026-03-20T21:38:08.1093559+00:00",
          "IsActive": true
        },
        {
          "Id": "80f61b22-95b1-4270-a257-55b520fc3195",
          "CompanyId": 2,
          "Name": "sample string 3",
          "DisplayName": "sample string 4",
          "Description": "sample string 5",
          "Rate": 6.1,
          "TaxRateType": "sample string 7",
          "TaxCalculatedOn": "sample string 8",
          "Layer": 9,
          "StartDateUtc": "2026-03-20T21:38:08.1093559+00:00",
          "EndDateUtc": "2026-03-20T21:38:08.1093559+00:00",
          "IsActive": true
        }
      ]
    }
  },
  {
    "Id": "423e4366-75de-4ed8-838d-4efed7a6f3cf",
    "CompanyId": 2,
    "Name": "sample string 3",
    "Description": "sample string 4",
    "IsDefault": true,
    "ProductCatalogIds": [
      "a25be6e8-eb79-4c90-b90b-ae8963470334",
      "39eec48c-867e-4310-b583-b5994d837dd8"
    ],
    "TaxMapping": {
      "Id": "9b03ed41-31de-42b0-a476-8157cbc70b96",
      "CompanyId": 2,
      "TaxCategory": "sample string 3",
      "TaxCategoryId": "55d293cc-ec14-4fa8-8bc3-45504cacdc17",
      "CorrelationId": "06f5634e-fbca-4c17-8c94-d5439565fb8f",
      "TaxRateIds": [
        "2c87ad86-6d2d-41c3-97b0-4c9013b8eb23",
        "aa30ec0f-d79a-4ccc-b510-1d6e5addbb4d"
      ],
      "TaxRates": [
        {
          "Id": "80f61b22-95b1-4270-a257-55b520fc3195",
          "CompanyId": 2,
          "Name": "sample string 3",
          "DisplayName": "sample string 4",
          "Description": "sample string 5",
          "Rate": 6.1,
          "TaxRateType": "sample string 7",
          "TaxCalculatedOn": "sample string 8",
          "Layer": 9,
          "StartDateUtc": "2026-03-20T21:38:08.1093559+00:00",
          "EndDateUtc": "2026-03-20T21:38:08.1093559+00:00",
          "IsActive": true
        },
        {
          "Id": "80f61b22-95b1-4270-a257-55b520fc3195",
          "CompanyId": 2,
          "Name": "sample string 3",
          "DisplayName": "sample string 4",
          "Description": "sample string 5",
          "Rate": 6.1,
          "TaxRateType": "sample string 7",
          "TaxCalculatedOn": "sample string 8",
          "Layer": 9,
          "StartDateUtc": "2026-03-20T21:38:08.1093559+00:00",
          "EndDateUtc": "2026-03-20T21:38:08.1093559+00:00",
          "IsActive": true
        }
      ]
    }
  }
]