POST v1/companies/{companyId}/DetailedProductData/UpdatedAsOf/{updatedAsOfUTC}
This call is intended for incremental updates.
Information:
Additional Documentation
See Cova Data Platform API guide
Base URL:
https://api.covasoft.net/dataplatform
Example of a call would be:
POST /dataplatform/v1/Companies/{companyId}/DetailedProductData/UpdatedAsOf/{updatedAsOfUtc}
Host: api.covasoft.net
Authorization: Bearer {your token}
Accept: application/json
Content-Type: application/json
{
"LocationId": 12346,
"IncludeProductSkusAndUpcs": true,
"IncludeProductSpecifications": true,
"IncludeClassifications": false,
"IncludeProductAssets": true,
"IncludeAvailability": true,
"IncludePackageDetails": true,
"IncludePricing": true,
"IncludeTaxes": true,
"InStockOnly": false,
"IncludeAllLifecycles": false,
"SellingRoomOnly": true,
"Skip": 0,
"Top": 100
}
Request Information
URI Parameters
| Name | Description | Type | Additional information |
|---|---|---|---|
| companyId | integer |
Required |
|
| updatedAsOfUTC | date |
Required |
Body Parameters
Properties to define which items in the model to return.
DetailedProductDataRequestResource| Name | Description | Type | Additional information |
|---|---|---|---|
| LocationId |
If provided only data for the provided location will be returned. If null is provided information for all locations will be returned. |
integer |
None. |
| IncludeProductSkusAndUpcs |
Indicates whether to include product SKUs and UPCs. |
boolean |
None. |
| IncludeProductSpecifications |
Indicates whether to include product specifications. |
boolean |
None. |
| IncludeProductAssets |
Indicates whether to include product assets. |
boolean |
None. |
| IncludeAvailability |
Indicates whether to include availability data. |
boolean |
None. |
| IncludePackageDetails |
Indicates whether to include package details for any packages associated with the product. |
boolean |
None. |
| InStockOnly |
Indicates whether to only include availability data for products that have stock (Quantity > 0). Only applies if IncludeAvailability is true. NOTE: this does not exclude product details for items without stock. |
boolean |
None. |
| SellingRoomOnly |
Indicates whether to include product availability data for all rooms or only the default selling room. Only applies if IncludeAvailability is true. |
boolean |
None. |
| IncludePricing |
Indicates whether to include product pricing data. |
boolean |
None. |
| Skip |
Number of records to skip. |
integer |
None. |
| Top |
Number of records to take. |
integer |
Range: inclusive between 1 and 500 |
| IncludeTaxes |
Indicates whether to include product tax data. |
boolean |
None. |
| IncludeClassifications |
Indicates whether to include the canonical classification collection. |
boolean |
None. |
| IncludeAllLifecycles |
Indicates whether to include all lifecycles, or only Active products. |
boolean |
None. |
| IncludeArchived |
Indicates whether to include archived products. |
boolean |
None. |
| IncludeRegularPricingOnly |
Indicates whether to include all types of prices (regular, group, tier) or just regular prices. Only applies if IncludePricing is true. |
boolean |
None. |
Request Formats
application/json, text/json
Sample:
{
"LocationId": 1,
"IncludeProductSkusAndUpcs": true,
"IncludeProductSpecifications": true,
"IncludeProductAssets": true,
"IncludeAvailability": true,
"IncludePackageDetails": true,
"InStockOnly": true,
"SellingRoomOnly": true,
"IncludePricing": true,
"Skip": 9,
"Top": 10,
"IncludeTaxes": true,
"IncludeClassifications": true,
"IncludeAllLifecycles": true,
"IncludeArchived": true,
"IncludeRegularPricingOnly": true
}
Response Information
Resource Description
DetailedProductDataResource| Name | Description | Type | Additional information |
|---|---|---|---|
| Products | Collection of DetailedProductResource |
None. |
|
| Packages | Collection of PackageResource |
None. |
|
| TaxRates | Collection of TaxRateResource |
None. |
|
| Classifications | Collection of ClassificationResource |
None. |
Response Formats
application/json, text/json
Sample:
{
"Products": [
{
"ProductId": "960dacdf-ad82-41e2-b08c-d8270dac612a",
"MasterProductId": 2,
"MasterProductName": 3,
"VariationId": 1,
"Slug": "sample string 4",
"CatalogSku": "sample string 5",
"IsArchived": true,
"MeasurementType": "sample string 7",
"IsBatchTracked": true,
"IsNonStock": true,
"LifeCycle": "sample string 10",
"ClassificationId": 11,
"ClassificationName": "sample string 12",
"ClassificationPath": "sample string 13",
"Name": "sample string 14",
"ShortDescription": "sample string 15",
"LongDescription": "sample string 16",
"HeroShotAssetId": "e4d9db6b-2250-4a31-9523-d7bd9debfdfe",
"HeroShotUri": "sample string 17",
"SupplierSkus": [
{
"SKU": "sample string 1",
"SupplierId": 1,
"Supplier": "sample string 2",
"Description": "sample string 3"
},
{
"SKU": "sample string 1",
"SupplierId": 1,
"Supplier": "sample string 2",
"Description": "sample string 3"
}
],
"ManufacturerSkus": [
{
"SKU": "sample string 1",
"Description": "sample string 2"
},
{
"SKU": "sample string 1",
"Description": "sample string 2"
}
],
"Upcs": [
{
"UPC": "sample string 1",
"Description": "sample string 2"
},
{
"UPC": "sample string 1",
"Description": "sample string 2"
}
],
"ProductSpecifications": [
{
"FieldGroupId": "fb8b8b28-fd5a-4f3b-aaa2-e78bbc6a982f",
"FieldGroup": "sample string 2",
"FieldId": 3,
"FieldName": "sample string 4",
"StringId": "sample string 5",
"DisplayName": "sample string 6",
"Value": "sample string 7",
"Type": "sample string 8",
"Unit": "sample string 9"
},
{
"FieldGroupId": "fb8b8b28-fd5a-4f3b-aaa2-e78bbc6a982f",
"FieldGroup": "sample string 2",
"FieldId": 3,
"FieldName": "sample string 4",
"StringId": "sample string 5",
"DisplayName": "sample string 6",
"Value": "sample string 7",
"Type": "sample string 8",
"Unit": "sample string 9"
}
],
"Assets": [
{
"Id": "3281405a-2601-4625-9fcc-99f494a8a7bd",
"Name": "sample string 2",
"Uri": "sample string 3",
"Type": "sample string 4",
"IsHidden": true
},
{
"Id": "3281405a-2601-4625-9fcc-99f494a8a7bd",
"Name": "sample string 2",
"Uri": "sample string 3",
"Type": "sample string 4",
"IsHidden": true
}
],
"Availability": [
{
"LocationId": 1,
"RoomId": 2,
"PackageId": "sample string 3",
"BatchId": "sample string 4",
"UnitId": 5,
"InStockQuantity": 6.0,
"OnOrderQuantity": 7.0,
"TransferInQuantity": 8.0,
"TransferOutQuantity": 9.0,
"TotalCostInStock": 10.0,
"UnitCost": 11.0,
"ReceivedDate": "2026-01-01T01:16:46.6478778+00:00",
"UpdatedDateUtc": "2026-01-01T01:16:46.6478778+00:00",
"IsSellingRoom": true,
"FirstReceivedDateUtc": "2026-01-01T01:16:46.6478778+00:00"
},
{
"LocationId": 1,
"RoomId": 2,
"PackageId": "sample string 3",
"BatchId": "sample string 4",
"UnitId": 5,
"InStockQuantity": 6.0,
"OnOrderQuantity": 7.0,
"TransferInQuantity": 8.0,
"TransferOutQuantity": 9.0,
"TotalCostInStock": 10.0,
"UnitCost": 11.0,
"ReceivedDate": "2026-01-01T01:16:46.6478778+00:00",
"UpdatedDateUtc": "2026-01-01T01:16:46.6478778+00:00",
"IsSellingRoom": true,
"FirstReceivedDateUtc": "2026-01-01T01:16:46.6478778+00:00"
}
],
"Prices": [
{
"LocationId": 1,
"ProductId": "5004fd30-a3f2-4648-aa1a-df91b3062773",
"TierId": 1,
"TierName": "sample string 3",
"TierQuantity": 1.0,
"GroupId": 1,
"GroupName": "sample string 4",
"ShelfId": 1,
"ShelfName": "sample string 5",
"Price": 6.0,
"AtTierPrice": 1.0,
"SalePrices": [
{
"SalePrice": 1.0,
"AtTierSalePrice": 1.0,
"StartDateUtc": "2026-01-01T01:16:46.6478778+00:00",
"StopDateUtc": "2026-01-01T01:16:46.6478778+00:00"
},
{
"SalePrice": 1.0,
"AtTierSalePrice": 1.0,
"StartDateUtc": "2026-01-01T01:16:46.6478778+00:00",
"StopDateUtc": "2026-01-01T01:16:46.6478778+00:00"
}
],
"UpdatedDateUtc": "2026-01-01T01:16:46.6478778+00:00"
},
{
"LocationId": 1,
"ProductId": "5004fd30-a3f2-4648-aa1a-df91b3062773",
"TierId": 1,
"TierName": "sample string 3",
"TierQuantity": 1.0,
"GroupId": 1,
"GroupName": "sample string 4",
"ShelfId": 1,
"ShelfName": "sample string 5",
"Price": 6.0,
"AtTierPrice": 1.0,
"SalePrices": [
{
"SalePrice": 1.0,
"AtTierSalePrice": 1.0,
"StartDateUtc": "2026-01-01T01:16:46.6478778+00:00",
"StopDateUtc": "2026-01-01T01:16:46.6478778+00:00"
},
{
"SalePrice": 1.0,
"AtTierSalePrice": 1.0,
"StartDateUtc": "2026-01-01T01:16:46.6478778+00:00",
"StopDateUtc": "2026-01-01T01:16:46.6478778+00:00"
}
],
"UpdatedDateUtc": "2026-01-01T01:16:46.6478778+00:00"
}
],
"CreatedDateUtc": "2026-01-01T01:16:46.6478778+00:00",
"UpdatedDateUtc": "2026-01-01T01:16:46.6478778+00:00",
"ApplicableTaxRates": [
"c7cafe35-9214-4fe9-b8bc-947a7c41766f",
"91acbc54-2495-4c6c-b6fb-9e286a80f6f5"
],
"ClassificationTreeId": 20,
"Manufacturer": "sample string 21",
"MSRP": 1.0,
"MSRPCurrencyCode": "sample string 22",
"CompanyLevelRegularPrice": {
"Price": 1.0,
"SalePrices": [
{
"SalePrice": 1.0,
"StartDateUtc": "2026-01-01T01:16:46.6478778+00:00",
"StopDateUtc": "2026-01-01T01:16:46.6478778+00:00"
},
{
"SalePrice": 1.0,
"StartDateUtc": "2026-01-01T01:16:46.6478778+00:00",
"StopDateUtc": "2026-01-01T01:16:46.6478778+00:00"
}
]
}
},
{
"ProductId": "960dacdf-ad82-41e2-b08c-d8270dac612a",
"MasterProductId": 2,
"MasterProductName": 3,
"VariationId": 1,
"Slug": "sample string 4",
"CatalogSku": "sample string 5",
"IsArchived": true,
"MeasurementType": "sample string 7",
"IsBatchTracked": true,
"IsNonStock": true,
"LifeCycle": "sample string 10",
"ClassificationId": 11,
"ClassificationName": "sample string 12",
"ClassificationPath": "sample string 13",
"Name": "sample string 14",
"ShortDescription": "sample string 15",
"LongDescription": "sample string 16",
"HeroShotAssetId": "e4d9db6b-2250-4a31-9523-d7bd9debfdfe",
"HeroShotUri": "sample string 17",
"SupplierSkus": [
{
"SKU": "sample string 1",
"SupplierId": 1,
"Supplier": "sample string 2",
"Description": "sample string 3"
},
{
"SKU": "sample string 1",
"SupplierId": 1,
"Supplier": "sample string 2",
"Description": "sample string 3"
}
],
"ManufacturerSkus": [
{
"SKU": "sample string 1",
"Description": "sample string 2"
},
{
"SKU": "sample string 1",
"Description": "sample string 2"
}
],
"Upcs": [
{
"UPC": "sample string 1",
"Description": "sample string 2"
},
{
"UPC": "sample string 1",
"Description": "sample string 2"
}
],
"ProductSpecifications": [
{
"FieldGroupId": "fb8b8b28-fd5a-4f3b-aaa2-e78bbc6a982f",
"FieldGroup": "sample string 2",
"FieldId": 3,
"FieldName": "sample string 4",
"StringId": "sample string 5",
"DisplayName": "sample string 6",
"Value": "sample string 7",
"Type": "sample string 8",
"Unit": "sample string 9"
},
{
"FieldGroupId": "fb8b8b28-fd5a-4f3b-aaa2-e78bbc6a982f",
"FieldGroup": "sample string 2",
"FieldId": 3,
"FieldName": "sample string 4",
"StringId": "sample string 5",
"DisplayName": "sample string 6",
"Value": "sample string 7",
"Type": "sample string 8",
"Unit": "sample string 9"
}
],
"Assets": [
{
"Id": "3281405a-2601-4625-9fcc-99f494a8a7bd",
"Name": "sample string 2",
"Uri": "sample string 3",
"Type": "sample string 4",
"IsHidden": true
},
{
"Id": "3281405a-2601-4625-9fcc-99f494a8a7bd",
"Name": "sample string 2",
"Uri": "sample string 3",
"Type": "sample string 4",
"IsHidden": true
}
],
"Availability": [
{
"LocationId": 1,
"RoomId": 2,
"PackageId": "sample string 3",
"BatchId": "sample string 4",
"UnitId": 5,
"InStockQuantity": 6.0,
"OnOrderQuantity": 7.0,
"TransferInQuantity": 8.0,
"TransferOutQuantity": 9.0,
"TotalCostInStock": 10.0,
"UnitCost": 11.0,
"ReceivedDate": "2026-01-01T01:16:46.6478778+00:00",
"UpdatedDateUtc": "2026-01-01T01:16:46.6478778+00:00",
"IsSellingRoom": true,
"FirstReceivedDateUtc": "2026-01-01T01:16:46.6478778+00:00"
},
{
"LocationId": 1,
"RoomId": 2,
"PackageId": "sample string 3",
"BatchId": "sample string 4",
"UnitId": 5,
"InStockQuantity": 6.0,
"OnOrderQuantity": 7.0,
"TransferInQuantity": 8.0,
"TransferOutQuantity": 9.0,
"TotalCostInStock": 10.0,
"UnitCost": 11.0,
"ReceivedDate": "2026-01-01T01:16:46.6478778+00:00",
"UpdatedDateUtc": "2026-01-01T01:16:46.6478778+00:00",
"IsSellingRoom": true,
"FirstReceivedDateUtc": "2026-01-01T01:16:46.6478778+00:00"
}
],
"Prices": [
{
"LocationId": 1,
"ProductId": "5004fd30-a3f2-4648-aa1a-df91b3062773",
"TierId": 1,
"TierName": "sample string 3",
"TierQuantity": 1.0,
"GroupId": 1,
"GroupName": "sample string 4",
"ShelfId": 1,
"ShelfName": "sample string 5",
"Price": 6.0,
"AtTierPrice": 1.0,
"SalePrices": [
{
"SalePrice": 1.0,
"AtTierSalePrice": 1.0,
"StartDateUtc": "2026-01-01T01:16:46.6478778+00:00",
"StopDateUtc": "2026-01-01T01:16:46.6478778+00:00"
},
{
"SalePrice": 1.0,
"AtTierSalePrice": 1.0,
"StartDateUtc": "2026-01-01T01:16:46.6478778+00:00",
"StopDateUtc": "2026-01-01T01:16:46.6478778+00:00"
}
],
"UpdatedDateUtc": "2026-01-01T01:16:46.6478778+00:00"
},
{
"LocationId": 1,
"ProductId": "5004fd30-a3f2-4648-aa1a-df91b3062773",
"TierId": 1,
"TierName": "sample string 3",
"TierQuantity": 1.0,
"GroupId": 1,
"GroupName": "sample string 4",
"ShelfId": 1,
"ShelfName": "sample string 5",
"Price": 6.0,
"AtTierPrice": 1.0,
"SalePrices": [
{
"SalePrice": 1.0,
"AtTierSalePrice": 1.0,
"StartDateUtc": "2026-01-01T01:16:46.6478778+00:00",
"StopDateUtc": "2026-01-01T01:16:46.6478778+00:00"
},
{
"SalePrice": 1.0,
"AtTierSalePrice": 1.0,
"StartDateUtc": "2026-01-01T01:16:46.6478778+00:00",
"StopDateUtc": "2026-01-01T01:16:46.6478778+00:00"
}
],
"UpdatedDateUtc": "2026-01-01T01:16:46.6478778+00:00"
}
],
"CreatedDateUtc": "2026-01-01T01:16:46.6478778+00:00",
"UpdatedDateUtc": "2026-01-01T01:16:46.6478778+00:00",
"ApplicableTaxRates": [
"c7cafe35-9214-4fe9-b8bc-947a7c41766f",
"91acbc54-2495-4c6c-b6fb-9e286a80f6f5"
],
"ClassificationTreeId": 20,
"Manufacturer": "sample string 21",
"MSRP": 1.0,
"MSRPCurrencyCode": "sample string 22",
"CompanyLevelRegularPrice": {
"Price": 1.0,
"SalePrices": [
{
"SalePrice": 1.0,
"StartDateUtc": "2026-01-01T01:16:46.6478778+00:00",
"StopDateUtc": "2026-01-01T01:16:46.6478778+00:00"
},
{
"SalePrice": 1.0,
"StartDateUtc": "2026-01-01T01:16:46.6478778+00:00",
"StopDateUtc": "2026-01-01T01:16:46.6478778+00:00"
}
]
}
}
],
"Packages": [
{
"PackageId": "sample string 1",
"BatchId": "sample string 2",
"ExpiryDate": "2026-01-01T01:16:46.6478778+00:00",
"Strain": "sample string 3",
"SupplierLicense": "sample string 4",
"TestDate": "2026-01-01T01:16:46.6478778+00:00",
"HarvestDate": "2026-01-01T01:16:46.6478778+00:00",
"TestingFacilityName": "sample string 5",
"TestBatchNumber": "sample string 6",
"SupplierName": "sample string 7",
"SupplierId": 1,
"TerpeneProfile": "sample string 8",
"ReceivingId": "ced0a0d4-6306-4295-bc6e-e2f4e5baa00c",
"ReceivingDate": "2026-01-01T01:16:46.6478778+00:00",
"Cannabinoids": [
{
"CannabinoidType": "sample string 1",
"MeasurementType": "sample string 2",
"MinValue": 3.0,
"MaxValue": 4.0
},
{
"CannabinoidType": "sample string 1",
"MeasurementType": "sample string 2",
"MinValue": 3.0,
"MaxValue": 4.0
}
],
"PackagedDate": "2026-01-01T01:16:46.6478778+00:00",
"ProductionDate": "2026-01-01T01:16:46.6478778+00:00",
"CreatedDateUtc": "2026-01-01T01:16:46.6478778+00:00",
"UpdatedDateUtc": "2026-01-01T01:16:46.6478778+00:00"
},
{
"PackageId": "sample string 1",
"BatchId": "sample string 2",
"ExpiryDate": "2026-01-01T01:16:46.6478778+00:00",
"Strain": "sample string 3",
"SupplierLicense": "sample string 4",
"TestDate": "2026-01-01T01:16:46.6478778+00:00",
"HarvestDate": "2026-01-01T01:16:46.6478778+00:00",
"TestingFacilityName": "sample string 5",
"TestBatchNumber": "sample string 6",
"SupplierName": "sample string 7",
"SupplierId": 1,
"TerpeneProfile": "sample string 8",
"ReceivingId": "ced0a0d4-6306-4295-bc6e-e2f4e5baa00c",
"ReceivingDate": "2026-01-01T01:16:46.6478778+00:00",
"Cannabinoids": [
{
"CannabinoidType": "sample string 1",
"MeasurementType": "sample string 2",
"MinValue": 3.0,
"MaxValue": 4.0
},
{
"CannabinoidType": "sample string 1",
"MeasurementType": "sample string 2",
"MinValue": 3.0,
"MaxValue": 4.0
}
],
"PackagedDate": "2026-01-01T01:16:46.6478778+00:00",
"ProductionDate": "2026-01-01T01:16:46.6478778+00:00",
"CreatedDateUtc": "2026-01-01T01:16:46.6478778+00:00",
"UpdatedDateUtc": "2026-01-01T01:16:46.6478778+00:00"
}
],
"TaxRates": [
{
"Id": "a385d1e3-3ce3-4e15-8341-532f27d3a442",
"Name": "sample string 2",
"Type": "sample string 3",
"Rate": 4.0,
"Layer": 5,
"CalculatedOn": "sample string 6",
"Locations": [
1,
2
]
},
{
"Id": "a385d1e3-3ce3-4e15-8341-532f27d3a442",
"Name": "sample string 2",
"Type": "sample string 3",
"Rate": 4.0,
"Layer": 5,
"CalculatedOn": "sample string 6",
"Locations": [
1,
2
]
}
],
"Classifications": [
{
"TreeId": 1,
"Id": 2,
"Name": "sample string 3",
"ParentCategories": [
{
"Id": 1,
"Name": "sample string 2"
},
{
"Id": 1,
"Name": "sample string 2"
}
]
},
{
"TreeId": 1,
"Id": 2,
"Name": "sample string 3",
"ParentCategories": [
{
"Id": 1,
"Name": "sample string 2"
},
{
"Id": 1,
"Name": "sample string 2"
}
]
}
]
}