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 | Description | 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": "29b9feb0-cdf4-4424-a018-27c3b96c3b61",
    "CompanyId": 2,
    "Name": "sample string 3",
    "Description": "sample string 4",
    "IsDefault": true,
    "ProductCatalogIds": [
      "cabac751-5a37-488e-bb1d-ce8cc6905615",
      "113cb288-2b5e-4d55-9dbc-4c910627841d"
    ],
    "TaxMapping": {
      "Id": "2492b80b-b3dd-4641-8a60-91e7ecc0a46a",
      "CompanyId": 2,
      "TaxCategory": "sample string 3",
      "TaxCategoryId": "af5e8231-a206-49a6-b1c3-61017bdbef5d",
      "CorrelationId": "b0352e0d-3d2a-4ed0-a08d-ee18694676ef",
      "TaxRateIds": [
        "f7461a45-1d63-4e2f-8b71-a5449f8cd35e",
        "ac61dc54-f3d4-4d41-a00a-569f74abdb4f"
      ],
      "TaxRates": [
        {
          "Id": "b74d8b05-83fb-4926-98c8-9a94b98b647f",
          "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": "2025-10-31T11:21:42.3758818+00:00",
          "EndDateUtc": "2025-10-31T11:21:42.3758818+00:00",
          "IsActive": true
        },
        {
          "Id": "b74d8b05-83fb-4926-98c8-9a94b98b647f",
          "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": "2025-10-31T11:21:42.3758818+00:00",
          "EndDateUtc": "2025-10-31T11:21:42.3758818+00:00",
          "IsActive": true
        }
      ]
    }
  },
  {
    "Id": "29b9feb0-cdf4-4424-a018-27c3b96c3b61",
    "CompanyId": 2,
    "Name": "sample string 3",
    "Description": "sample string 4",
    "IsDefault": true,
    "ProductCatalogIds": [
      "cabac751-5a37-488e-bb1d-ce8cc6905615",
      "113cb288-2b5e-4d55-9dbc-4c910627841d"
    ],
    "TaxMapping": {
      "Id": "2492b80b-b3dd-4641-8a60-91e7ecc0a46a",
      "CompanyId": 2,
      "TaxCategory": "sample string 3",
      "TaxCategoryId": "af5e8231-a206-49a6-b1c3-61017bdbef5d",
      "CorrelationId": "b0352e0d-3d2a-4ed0-a08d-ee18694676ef",
      "TaxRateIds": [
        "f7461a45-1d63-4e2f-8b71-a5449f8cd35e",
        "ac61dc54-f3d4-4d41-a00a-569f74abdb4f"
      ],
      "TaxRates": [
        {
          "Id": "b74d8b05-83fb-4926-98c8-9a94b98b647f",
          "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": "2025-10-31T11:21:42.3758818+00:00",
          "EndDateUtc": "2025-10-31T11:21:42.3758818+00:00",
          "IsActive": true
        },
        {
          "Id": "b74d8b05-83fb-4926-98c8-9a94b98b647f",
          "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": "2025-10-31T11:21:42.3758818+00:00",
          "EndDateUtc": "2025-10-31T11:21:42.3758818+00:00",
          "IsActive": true
        }
      ]
    }
  }
]