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": "aa98d7c9-ff8d-46f4-b19b-4b8652154b29",
"CompanyId": 2,
"Name": "sample string 3",
"Description": "sample string 4",
"IsDefault": true,
"ProductCatalogIds": [
"02ea78bc-e457-4454-998e-e1d3409e1c7d",
"45b67eab-b0b9-470d-9c1f-f47332926964"
],
"TaxMapping": {
"Id": "74b256b1-86cd-4ec3-af47-77bb6c9be508",
"CompanyId": 2,
"TaxCategory": "sample string 3",
"TaxCategoryId": "f441fd03-2d8b-4722-98ec-5afe0b1a384a",
"CorrelationId": "15ddf20e-0464-4f83-bdca-88c49145acf0",
"TaxRateIds": [
"a43e0b51-896d-42ba-839d-d1a1c5b17b93",
"69608402-8519-4b5b-ac21-51d74bd6ca65"
],
"TaxRates": [
{
"Id": "b4655cd7-0439-4bd4-be5b-fc4e857fcaee",
"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-07T14:12:12.9057905+00:00",
"EndDateUtc": "2026-02-07T14:12:12.9057905+00:00",
"IsActive": true
},
{
"Id": "b4655cd7-0439-4bd4-be5b-fc4e857fcaee",
"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-07T14:12:12.9057905+00:00",
"EndDateUtc": "2026-02-07T14:12:12.9057905+00:00",
"IsActive": true
}
]
}
},
{
"Id": "aa98d7c9-ff8d-46f4-b19b-4b8652154b29",
"CompanyId": 2,
"Name": "sample string 3",
"Description": "sample string 4",
"IsDefault": true,
"ProductCatalogIds": [
"02ea78bc-e457-4454-998e-e1d3409e1c7d",
"45b67eab-b0b9-470d-9c1f-f47332926964"
],
"TaxMapping": {
"Id": "74b256b1-86cd-4ec3-af47-77bb6c9be508",
"CompanyId": 2,
"TaxCategory": "sample string 3",
"TaxCategoryId": "f441fd03-2d8b-4722-98ec-5afe0b1a384a",
"CorrelationId": "15ddf20e-0464-4f83-bdca-88c49145acf0",
"TaxRateIds": [
"a43e0b51-896d-42ba-839d-d1a1c5b17b93",
"69608402-8519-4b5b-ac21-51d74bd6ca65"
],
"TaxRates": [
{
"Id": "b4655cd7-0439-4bd4-be5b-fc4e857fcaee",
"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-07T14:12:12.9057905+00:00",
"EndDateUtc": "2026-02-07T14:12:12.9057905+00:00",
"IsActive": true
},
{
"Id": "b4655cd7-0439-4bd4-be5b-fc4e857fcaee",
"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-07T14:12:12.9057905+00:00",
"EndDateUtc": "2026-02-07T14:12:12.9057905+00:00",
"IsActive": true
}
]
}
}
]