GET insights/reports/by-code-name/{reportCodeName}
Next, call this. You will get detailed information about a report, including what filters and output columns it has.
Request Information
URI Parameters
| Name | Description | Type | Additional information |
|---|---|---|---|
| reportCodeName | string | Required |
Body Parameters
None.
Response Information
Resource Description
Next, call this. You will get detailed information about a report, including what filters and output columns it has.
ReportSchema| Name | Description | Type | Additional information |
|---|---|---|---|
| CodeName | A human readable unique identifier for the report | string | None. |
| DisplayName | The user friendly name | string | None. |
| Description | A description of what the report does; Contains markup | string | None. |
| Filters | Possible filters you can send | Collection of ReportFilterSchema | None. |
| OutputColumns | Possible output columns you can request | Collection of ReportColumnSchema | None. |
| OrderByOptions | Codenames of columns which are available to order the output data by | Collection of string | None. |
Response Formats
application/json, text/json
Sample:
{
"CodeName": "product-stock-levels",
"DisplayName": "Product Stock Levels",
"Description": "<p>This report shows current stock levels for all products across your stock locations.</p>",
"Filters": [
{
"CodeName": "SKU",
"FilterType": "Text",
"DefaultDisplayName": "Product SKU"
},
{
"CodeName": "StockLocationId",
"FilterType": "ForeignKey",
"DefaultDisplayName": "Stock Location",
"DropdownCodeName": "StockLocations"
},
{
"CodeName": "LastUpdatedDate",
"FilterType": "Date",
"DefaultDisplayName": "Last Updated"
},
{
"CodeName": "QuantityInStock",
"FilterType": "Numerical",
"DefaultDisplayName": "Quantity in Stock"
}
],
"OutputColumns": [
{
"CodeName": "ProductId",
"OutputType": "Integer",
"DefaultDisplayName": "Product ID"
},
{
"CodeName": "SKU",
"OutputType": "String",
"DefaultDisplayName": "Product SKU"
},
{
"CodeName": "ProductName",
"OutputType": "String",
"DefaultDisplayName": "Product Name"
},
{
"CodeName": "StockLocation",
"OutputType": "String",
"DefaultDisplayName": "Stock Location"
},
{
"CodeName": "QuantityInStock",
"OutputType": "Integer",
"DefaultDisplayName": "Quantity Available"
},
{
"CodeName": "LastUpdated",
"OutputType": "DateTime",
"DefaultDisplayName": "Last Updated"
}
],
"OrderByOptions": [
"SKU",
"ProductName",
"QuantityInStock",
"LastUpdated"
]
}