> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chataigne.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Financial analytics

> Retrieve gross order value, average order value, and daily financial evolution.

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

```text Location theme={null}
GET /v1/locations/{location_id}/analytics/financials
```

```text Business organization theme={null}
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.

<CodeGroup>
  ```bash Location request theme={null}
  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"
  ```

  ```json Location response theme={null}
  {
    "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 }]
  }
  ```
</CodeGroup>

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.