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": "7029e945-078b-41c6-92b8-2f19e07359f3",
"CompanyId": 2,
"Name": "sample string 3",
"Description": "sample string 4",
"IsDefault": true,
"ProductCatalogIds": [
"7d97001d-9336-4b24-93bc-657b19b66a89",
"5183bb5f-a149-4d44-a03a-f6d894813aa1"
],
"TaxMapping": {
"Id": "7580ada5-d558-426d-9eba-7435b91a0570",
"CompanyId": 2,
"TaxCategory": "sample string 3",
"TaxCategoryId": "e3769c3a-461e-4357-9c05-d27379cba14b",
"CorrelationId": "3021444a-18c1-453d-a54f-9a97a4752453",
"TaxRateIds": [
"e27c45a9-c281-4288-a75d-e74c5cf8023b",
"5ef76f9a-90c7-4ed1-84ea-f35b020c73cb"
],
"TaxRates": [
{
"Id": "4a9951e4-90c4-4a63-a76d-a1a12b8b7732",
"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-11T16:31:28.9869323+00:00",
"EndDateUtc": "2025-12-11T16:31:28.9869323+00:00",
"IsActive": true
},
{
"Id": "4a9951e4-90c4-4a63-a76d-a1a12b8b7732",
"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-11T16:31:28.9869323+00:00",
"EndDateUtc": "2025-12-11T16:31:28.9869323+00:00",
"IsActive": true
}
]
}
},
{
"Id": "7029e945-078b-41c6-92b8-2f19e07359f3",
"CompanyId": 2,
"Name": "sample string 3",
"Description": "sample string 4",
"IsDefault": true,
"ProductCatalogIds": [
"7d97001d-9336-4b24-93bc-657b19b66a89",
"5183bb5f-a149-4d44-a03a-f6d894813aa1"
],
"TaxMapping": {
"Id": "7580ada5-d558-426d-9eba-7435b91a0570",
"CompanyId": 2,
"TaxCategory": "sample string 3",
"TaxCategoryId": "e3769c3a-461e-4357-9c05-d27379cba14b",
"CorrelationId": "3021444a-18c1-453d-a54f-9a97a4752453",
"TaxRateIds": [
"e27c45a9-c281-4288-a75d-e74c5cf8023b",
"5ef76f9a-90c7-4ed1-84ea-f35b020c73cb"
],
"TaxRates": [
{
"Id": "4a9951e4-90c4-4a63-a76d-a1a12b8b7732",
"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-11T16:31:28.9869323+00:00",
"EndDateUtc": "2025-12-11T16:31:28.9869323+00:00",
"IsActive": true
},
{
"Id": "4a9951e4-90c4-4a63-a76d-a1a12b8b7732",
"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-11T16:31:28.9869323+00:00",
"EndDateUtc": "2025-12-11T16:31:28.9869323+00:00",
"IsActive": true
}
]
}
}
]