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": "9a1cf4c6-41bb-4b3d-b526-7d971c302058",
"CompanyId": 2,
"Name": "sample string 3",
"Description": "sample string 4",
"IsDefault": true,
"ProductCatalogIds": [
"08fa20f8-bb95-4470-aba4-578cad6cc7a3",
"91e22eeb-6507-44c4-a342-56464defc5a5"
],
"TaxMapping": {
"Id": "82399cc9-0202-47c2-997d-490b92543204",
"CompanyId": 2,
"TaxCategory": "sample string 3",
"TaxCategoryId": "ce3a8711-aa30-4cb9-9e1f-d1f6e0ede3d6",
"CorrelationId": "c7496a8b-8625-4441-848f-670a56efae4f",
"TaxRateIds": [
"6d5ab591-ea52-431c-92c1-d7d2cb06209a",
"8438d62c-afe9-4058-92bb-8e15470f59b0"
],
"TaxRates": [
{
"Id": "b05950b0-dc8c-4dbb-b77d-6818cf432c62",
"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-01-20T09:45:10.9190214+00:00",
"EndDateUtc": "2026-01-20T09:45:10.9190214+00:00",
"IsActive": true
},
{
"Id": "b05950b0-dc8c-4dbb-b77d-6818cf432c62",
"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-01-20T09:45:10.9190214+00:00",
"EndDateUtc": "2026-01-20T09:45:10.9190214+00:00",
"IsActive": true
}
]
}
},
{
"Id": "9a1cf4c6-41bb-4b3d-b526-7d971c302058",
"CompanyId": 2,
"Name": "sample string 3",
"Description": "sample string 4",
"IsDefault": true,
"ProductCatalogIds": [
"08fa20f8-bb95-4470-aba4-578cad6cc7a3",
"91e22eeb-6507-44c4-a342-56464defc5a5"
],
"TaxMapping": {
"Id": "82399cc9-0202-47c2-997d-490b92543204",
"CompanyId": 2,
"TaxCategory": "sample string 3",
"TaxCategoryId": "ce3a8711-aa30-4cb9-9e1f-d1f6e0ede3d6",
"CorrelationId": "c7496a8b-8625-4441-848f-670a56efae4f",
"TaxRateIds": [
"6d5ab591-ea52-431c-92c1-d7d2cb06209a",
"8438d62c-afe9-4058-92bb-8e15470f59b0"
],
"TaxRates": [
{
"Id": "b05950b0-dc8c-4dbb-b77d-6818cf432c62",
"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-01-20T09:45:10.9190214+00:00",
"EndDateUtc": "2026-01-20T09:45:10.9190214+00:00",
"IsActive": true
},
{
"Id": "b05950b0-dc8c-4dbb-b77d-6818cf432c62",
"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-01-20T09:45:10.9190214+00:00",
"EndDateUtc": "2026-01-20T09:45:10.9190214+00:00",
"IsActive": true
}
]
}
}
]