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": "120ec05d-18a9-453d-a9c9-55884dd3dfe1",
"CompanyId": 2,
"Name": "sample string 3",
"Description": "sample string 4",
"IsDefault": true,
"ProductCatalogIds": [
"bf2d10f2-cb64-4eba-9027-b4e4153f962c",
"2374cb42-5b17-44a6-895b-d1d2bb332156"
],
"TaxMapping": {
"Id": "2daa375f-694f-4b64-ba71-680e30305956",
"CompanyId": 2,
"TaxCategory": "sample string 3",
"TaxCategoryId": "1a19abd6-9244-4fa4-a287-8b6424cfef3b",
"CorrelationId": "997fc92c-a181-450d-a996-9dec86f36426",
"TaxRateIds": [
"87c3bc56-123c-4718-9311-75b045b492e9",
"bef7d255-4f0e-4e00-8097-f8992a18c41f"
],
"TaxRates": [
{
"Id": "96a5c746-edec-46f7-8711-4e73efbc6996",
"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-04-10T00:19:52.314757+00:00",
"EndDateUtc": "2026-04-10T00:19:52.314757+00:00",
"IsActive": true
},
{
"Id": "96a5c746-edec-46f7-8711-4e73efbc6996",
"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-04-10T00:19:52.314757+00:00",
"EndDateUtc": "2026-04-10T00:19:52.314757+00:00",
"IsActive": true
}
]
}
},
{
"Id": "120ec05d-18a9-453d-a9c9-55884dd3dfe1",
"CompanyId": 2,
"Name": "sample string 3",
"Description": "sample string 4",
"IsDefault": true,
"ProductCatalogIds": [
"bf2d10f2-cb64-4eba-9027-b4e4153f962c",
"2374cb42-5b17-44a6-895b-d1d2bb332156"
],
"TaxMapping": {
"Id": "2daa375f-694f-4b64-ba71-680e30305956",
"CompanyId": 2,
"TaxCategory": "sample string 3",
"TaxCategoryId": "1a19abd6-9244-4fa4-a287-8b6424cfef3b",
"CorrelationId": "997fc92c-a181-450d-a996-9dec86f36426",
"TaxRateIds": [
"87c3bc56-123c-4718-9311-75b045b492e9",
"bef7d255-4f0e-4e00-8097-f8992a18c41f"
],
"TaxRates": [
{
"Id": "96a5c746-edec-46f7-8711-4e73efbc6996",
"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-04-10T00:19:52.314757+00:00",
"EndDateUtc": "2026-04-10T00:19:52.314757+00:00",
"IsActive": true
},
{
"Id": "96a5c746-edec-46f7-8711-4e73efbc6996",
"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-04-10T00:19:52.314757+00:00",
"EndDateUtc": "2026-04-10T00:19:52.314757+00:00",
"IsActive": true
}
]
}
}
]