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": "375bb283-0d4f-4683-82d9-fcb576097ed4",
"CompanyId": 2,
"Name": "sample string 3",
"Description": "sample string 4",
"IsDefault": true,
"ProductCatalogIds": [
"fa7170bc-d8b7-41e3-8b20-d8d4561781e3",
"f95fc400-668b-45e9-9d9a-253050ef7f68"
],
"TaxMapping": {
"Id": "478a8adc-7ca4-48cf-b2c4-d093bfbbf806",
"CompanyId": 2,
"TaxCategory": "sample string 3",
"TaxCategoryId": "3a27768d-d95a-4ae0-b17d-16a13fe0d6ae",
"CorrelationId": "30787d65-37ba-4c4b-8b7e-d970839a76af",
"TaxRateIds": [
"df63f6ac-4bac-4936-bb49-9cc7ff24767b",
"88fdb67c-5723-484c-adc2-2e1d0124827c"
],
"TaxRates": [
{
"Id": "09946199-3473-410b-8c04-16483f4e77f6",
"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-11-21T14:55:36.5971276+00:00",
"EndDateUtc": "2025-11-21T14:55:36.5971276+00:00",
"IsActive": true
},
{
"Id": "09946199-3473-410b-8c04-16483f4e77f6",
"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-11-21T14:55:36.5971276+00:00",
"EndDateUtc": "2025-11-21T14:55:36.5971276+00:00",
"IsActive": true
}
]
}
},
{
"Id": "375bb283-0d4f-4683-82d9-fcb576097ed4",
"CompanyId": 2,
"Name": "sample string 3",
"Description": "sample string 4",
"IsDefault": true,
"ProductCatalogIds": [
"fa7170bc-d8b7-41e3-8b20-d8d4561781e3",
"f95fc400-668b-45e9-9d9a-253050ef7f68"
],
"TaxMapping": {
"Id": "478a8adc-7ca4-48cf-b2c4-d093bfbbf806",
"CompanyId": 2,
"TaxCategory": "sample string 3",
"TaxCategoryId": "3a27768d-d95a-4ae0-b17d-16a13fe0d6ae",
"CorrelationId": "30787d65-37ba-4c4b-8b7e-d970839a76af",
"TaxRateIds": [
"df63f6ac-4bac-4936-bb49-9cc7ff24767b",
"88fdb67c-5723-484c-adc2-2e1d0124827c"
],
"TaxRates": [
{
"Id": "09946199-3473-410b-8c04-16483f4e77f6",
"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-11-21T14:55:36.5971276+00:00",
"EndDateUtc": "2025-11-21T14:55:36.5971276+00:00",
"IsActive": true
},
{
"Id": "09946199-3473-410b-8c04-16483f4e77f6",
"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-11-21T14:55:36.5971276+00:00",
"EndDateUtc": "2025-11-21T14:55:36.5971276+00:00",
"IsActive": true
}
]
}
}
]