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": "0e26cda2-a375-4e2b-9b16-49859156509f",
"CompanyId": 2,
"Name": "sample string 3",
"Description": "sample string 4",
"IsDefault": true,
"ProductCatalogIds": [
"f4c1c508-7f35-4efe-b463-d58ef97a2d0e",
"97b09068-cbb4-46f8-a698-d40e687f0898"
],
"TaxMapping": {
"Id": "bb8fc239-8971-4a8f-b123-c214b784be8d",
"CompanyId": 2,
"TaxCategory": "sample string 3",
"TaxCategoryId": "3eb88c60-c2ff-4a51-ac74-1af6171d78a3",
"CorrelationId": "65cf6990-29f0-4d20-9ea2-4ad193d2fb73",
"TaxRateIds": [
"59ec483d-27a9-453a-a1a9-d8098101ca32",
"76ac77a9-127e-4b52-9e5c-07025f4ca48c"
],
"TaxRates": [
{
"Id": "e0eb8974-e920-4210-9edb-99ddc116b491",
"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-08-05T03:43:17.1109701+00:00",
"EndDateUtc": "2026-08-05T03:43:17.1109701+00:00",
"IsActive": true
},
{
"Id": "e0eb8974-e920-4210-9edb-99ddc116b491",
"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-08-05T03:43:17.1109701+00:00",
"EndDateUtc": "2026-08-05T03:43:17.1109701+00:00",
"IsActive": true
}
]
}
},
{
"Id": "0e26cda2-a375-4e2b-9b16-49859156509f",
"CompanyId": 2,
"Name": "sample string 3",
"Description": "sample string 4",
"IsDefault": true,
"ProductCatalogIds": [
"f4c1c508-7f35-4efe-b463-d58ef97a2d0e",
"97b09068-cbb4-46f8-a698-d40e687f0898"
],
"TaxMapping": {
"Id": "bb8fc239-8971-4a8f-b123-c214b784be8d",
"CompanyId": 2,
"TaxCategory": "sample string 3",
"TaxCategoryId": "3eb88c60-c2ff-4a51-ac74-1af6171d78a3",
"CorrelationId": "65cf6990-29f0-4d20-9ea2-4ad193d2fb73",
"TaxRateIds": [
"59ec483d-27a9-453a-a1a9-d8098101ca32",
"76ac77a9-127e-4b52-9e5c-07025f4ca48c"
],
"TaxRates": [
{
"Id": "e0eb8974-e920-4210-9edb-99ddc116b491",
"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-08-05T03:43:17.1109701+00:00",
"EndDateUtc": "2026-08-05T03:43:17.1109701+00:00",
"IsActive": true
},
{
"Id": "e0eb8974-e920-4210-9edb-99ddc116b491",
"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-08-05T03:43:17.1109701+00:00",
"EndDateUtc": "2026-08-05T03:43:17.1109701+00:00",
"IsActive": true
}
]
}
}
]