Comment on page
Orders by day
How to use the Metrics API to get the total number of orders of your organization, grouped by day
You want to get the total number of orders over a selected date and time range, grouped by day.
You need to perform a date breakdown query setting the required query keys as follows and adding the optional ones based on your needs:
Key | Value |
---|---|
by | order.current_date |
field | order.id |
operator | value_count |
interval | day |
Change the
interval
key if you want to group the results differently (e.g. by year
or hour
— default is month
).Make sure to set the desired date and time range using the
date_from
and date_to
keys in the filter. In this example, since the
date_field
isn't specified, the default value current_date
will be used. Being the same date time field used in the by
key of the query, you'll get in the response all the orders that actually changed their status each day within the selected date and time range (read more about this).Request
Response
The following request uses the Metrics API to get the total number of orders, grouped by day:
curl -g -X POST \
'https://{{your_domain}}.commercelayer.io/metrics/orders/date_breakdown' \
-H 'Accept: application/vnd.api.v1+json' \
-H 'Content-Type: application/vnd.api+json' \
-H 'Authorization: Bearer {{your_access_token}}' \
-d '{
"date_breakdown": {
"by": "order.current_date",
"field": "order.id",
"operator": "value_count",
"interval": "day"
},
"filter": {
"order": {
"date_from": "2021-01-01T00:00:00Z",
"date_to": "2021-12-31T23:59:00Z"
}
}
}'
On success, the API responds with a
200 OK
status code, returning the aggregated values in the data
object and extra information in the meta
object:{
"data": [
{
"date": "2021-01-01T00:00:00.000Z",
"value": 1196
},
{
"date": "2021-01-02T00:00:00.000Z",
"value": 1371
},
{
"date": "2021-01-03T00:00:00.000Z",
"value": 1574
},
{
"date": "2021-01-04T00:00:00.000Z",
"value": 1735
},
{ ... },
{
"date": "2021-12-30T00:00:00.000Z",
"value": 2344
},
{
"date": "2021-12-31T00:00:00.000Z",
"value": 1905
}
],
"meta": {
"type": "date_breakdown",
"trace_id": "fe571ea2-8a4f-4a5e-bd26-ac54651bb2e4",
"mode": "test",
"organization_id": "xYZkjABcde",
"market_ids": [ "yzXKjYzaCx", "..." ]
}
}
Last modified 9mo ago