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": "6dd47f1f-4e36-4fbd-9c76-f61741c7d156",
"CompanyId": 2,
"Name": "sample string 3",
"Description": "sample string 4",
"IsDefault": true,
"ProductCatalogIds": [
"315d8541-80ae-4091-8076-1364b457a9a8",
"fb75440c-cbb2-4f69-a6f5-a382ccb16521"
],
"TaxMapping": {
"Id": "de9089ec-7b4d-4909-b66f-bc4408d5e244",
"CompanyId": 2,
"TaxCategory": "sample string 3",
"TaxCategoryId": "c8cb42a8-0248-4f8f-a8fa-41cc884c34c7",
"CorrelationId": "542566d3-6922-4c78-a062-4c9773146600",
"TaxRateIds": [
"af9d130d-5b13-4af1-9968-d85ffaedb536",
"1b4ee093-ece1-466b-b2e1-08668b95219e"
],
"TaxRates": [
{
"Id": "167189e3-6449-4112-afd7-0e7b1edba478",
"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-02-23T02:04:30.5531502+00:00",
"EndDateUtc": "2026-02-23T02:04:30.5531502+00:00",
"IsActive": true
},
{
"Id": "167189e3-6449-4112-afd7-0e7b1edba478",
"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-02-23T02:04:30.5531502+00:00",
"EndDateUtc": "2026-02-23T02:04:30.5531502+00:00",
"IsActive": true
}
]
}
},
{
"Id": "6dd47f1f-4e36-4fbd-9c76-f61741c7d156",
"CompanyId": 2,
"Name": "sample string 3",
"Description": "sample string 4",
"IsDefault": true,
"ProductCatalogIds": [
"315d8541-80ae-4091-8076-1364b457a9a8",
"fb75440c-cbb2-4f69-a6f5-a382ccb16521"
],
"TaxMapping": {
"Id": "de9089ec-7b4d-4909-b66f-bc4408d5e244",
"CompanyId": 2,
"TaxCategory": "sample string 3",
"TaxCategoryId": "c8cb42a8-0248-4f8f-a8fa-41cc884c34c7",
"CorrelationId": "542566d3-6922-4c78-a062-4c9773146600",
"TaxRateIds": [
"af9d130d-5b13-4af1-9968-d85ffaedb536",
"1b4ee093-ece1-466b-b2e1-08668b95219e"
],
"TaxRates": [
{
"Id": "167189e3-6449-4112-afd7-0e7b1edba478",
"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-02-23T02:04:30.5531502+00:00",
"EndDateUtc": "2026-02-23T02:04:30.5531502+00:00",
"IsActive": true
},
{
"Id": "167189e3-6449-4112-afd7-0e7b1edba478",
"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-02-23T02:04:30.5531502+00:00",
"EndDateUtc": "2026-02-23T02:04:30.5531502+00:00",
"IsActive": true
}
]
}
}
]