Financial analytics - Chataigne Docs

Use the financial resource for order value and its evolution over time.

Location

GET /v1/locations/{location_id}/analytics/financials

Business organization

GET /v1/organizations/{organization_id}/analytics/financials

Statistics

Field	Meaning
`gross_order_value`	Total value of eligible orders after discounts, including delivery and service fees charged to customers.
`average_order_value`	Average eligible order value after discounts, excluding delivery and service fees.
`daily[].gross_order_value`	Gross order value for one local calendar date.

The location response carries one currency. The organization response returns by_currency; each entry combines only locations using that currency. average_order_value is weighted by the number of orders in each contributing location.

curl "https://server.chataigne.ai/v1/locations/loc_8sKq2bXt9mZ1/analytics/financials?from=2026-06-01T00:00:00Z&to=2026-06-30T23:59:59Z" \
  -H "x-api-key: $CHATAIGNE_API_KEY"

{
  "object": "location_financial_analytics",
  "location_id": "loc_8sKq2bXt9mZ1",
  "period": {
    "from": "2026-06-01T00:00:00.000Z",
    "to": "2026-06-30T23:59:59.000Z",
    "service_type": null
  },
  "currency": "EUR",
  "summary": {
    "gross_order_value": 9120.5,
    "average_order_value": 26.69
  },
  "daily": [{ "date": "2026-06-01", "gross_order_value": 420.5 }]
}

An organization with EUR and CHF locations returns two by_currency entries. Convert currencies in your own reporting layer only if you have an exchange-rate policy appropriate for the report date.

​Statistics

Statistics