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": "d4873ef3-5744-438c-a1b2-da19f1254e9b",
"CompanyId": 2,
"Name": "sample string 3",
"Description": "sample string 4",
"IsDefault": true,
"ProductCatalogIds": [
"04b58824-55d0-4987-9f03-d92e2a35532a",
"dbe2bdb2-bfc7-4d23-97fa-30f727fe8dea"
],
"TaxMapping": {
"Id": "0f737482-1546-4042-96d9-48c01945817f",
"CompanyId": 2,
"TaxCategory": "sample string 3",
"TaxCategoryId": "fe8463f3-653f-45e8-bde2-1a93d0eacdf2",
"CorrelationId": "9655e7dd-feec-4efa-bb2f-aea2b0de2d65",
"TaxRateIds": [
"c3d7663a-850a-4769-9e75-7fbf7f00df0d",
"b67c65e9-46b6-48a4-bec9-065f63c2a5d7"
],
"TaxRates": [
{
"Id": "7d26e85e-2670-4cf0-a421-831f44647389",
"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-12-09T21:20:18.1801254+00:00",
"EndDateUtc": "2025-12-09T21:20:18.1801254+00:00",
"IsActive": true
},
{
"Id": "7d26e85e-2670-4cf0-a421-831f44647389",
"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-12-09T21:20:18.1801254+00:00",
"EndDateUtc": "2025-12-09T21:20:18.1801254+00:00",
"IsActive": true
}
]
}
},
{
"Id": "d4873ef3-5744-438c-a1b2-da19f1254e9b",
"CompanyId": 2,
"Name": "sample string 3",
"Description": "sample string 4",
"IsDefault": true,
"ProductCatalogIds": [
"04b58824-55d0-4987-9f03-d92e2a35532a",
"dbe2bdb2-bfc7-4d23-97fa-30f727fe8dea"
],
"TaxMapping": {
"Id": "0f737482-1546-4042-96d9-48c01945817f",
"CompanyId": 2,
"TaxCategory": "sample string 3",
"TaxCategoryId": "fe8463f3-653f-45e8-bde2-1a93d0eacdf2",
"CorrelationId": "9655e7dd-feec-4efa-bb2f-aea2b0de2d65",
"TaxRateIds": [
"c3d7663a-850a-4769-9e75-7fbf7f00df0d",
"b67c65e9-46b6-48a4-bec9-065f63c2a5d7"
],
"TaxRates": [
{
"Id": "7d26e85e-2670-4cf0-a421-831f44647389",
"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-12-09T21:20:18.1801254+00:00",
"EndDateUtc": "2025-12-09T21:20:18.1801254+00:00",
"IsActive": true
},
{
"Id": "7d26e85e-2670-4cf0-a421-831f44647389",
"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-12-09T21:20:18.1801254+00:00",
"EndDateUtc": "2025-12-09T21:20:18.1801254+00:00",
"IsActive": true
}
]
}
}
]