---
title: "Statistics"
method: GET
path: "/tiles/cog/statistics"
tags: ["Cloud Optimized GeoTIFF"]
---

# Statistics

`GET /tiles/cog/statistics`

## Request

- Base URL: `https://app.chloris.earth` (the document declares no server; this is the origin it was published from)
- URL: `https://app.chloris.earth/tiles/cog/statistics`
- Auth: API key in query parameter `access_token`
- TypeScript: <https://skmtc.dev/chloris/apis/chloris-geospatial-s-dynamic-tiler/docs/tiles/cog/statistics/get.ts> (a function with typed inputs; its response is checked against the schema)

Get Dataset statistics.

## Query parameters

- `data_path` string, nullable: The reporting unit entry's dataPath parameter. Should be used instead of `url` in most cases.
- `carbon_pool` string, nullable: The carbon pool for the report unit layer. Valid options are: agb, bgb, dom. Defaults to agb. Requires data_path to be set.
- `product_type` string, nullable: The product type for the report unit layer. Valid options are: stock, change, cumulative_change, forest, nonforest, forest_area_gain, forest_area_loss, forest_area_degradation. Requires data_path to be set.
- `product_variant` string, nullable: The product variant id for the report unit layer. May be omitted to use the default variant. Requires data_path and product_type to be set. Deprecated in favor of carbon_pool and resolution.
- `resolution` integer, nullable: The nominal group distance in meters report unit layer. May be omitted to use highest resolution available for the given zoom level. Requires data_path and product_type to be set.
- `year` integer, nullable: The year for the report unit layer. Should be used instead of `bidx` in most cases. Requires data_path and product_type to be set.
- `analysis_completed_at` string, nullable: The analysisCompletedAt from the report unit entry to ensure the latest data is fetched.
- `url` string, nullable: Dataset URL, may be omitted if using data_path (recommended).
- `bidx` integer[], nullable: Dataset band indexes
- `expression` string, nullable: rio-tiler's band math expression
- `nodata` union: Overwrite internal Nodata value
  - number
  - integer
  - string
- `unscale` boolean, nullable: Apply internal Scale/Offset. Defaults to `False`.
- `resampling` 'nearest' | 'bilinear' | 'cubic' | 'cubic_spline' | 'lanczos' | 'average' | 'mode' | 'gauss' | 'rms', nullable: RasterIO resampling algorithm. Defaults to `nearest`.
- `reproject` 'nearest' | 'bilinear' | 'cubic' | 'cubic_spline' | 'lanczos' | 'average' | 'mode' | 'sum' | 'rms', nullable: WarpKernel resampling algorithm (only used when doing re-projection). Defaults to `nearest`.
- `max_size` integer
- `height` integer, nullable
- `width` integer, nullable
- `algorithm` 'hillshade' | 'contours' | 'normalizedIndex' | 'terrarium' | 'terrainrgb': Algorithm name
- `algorithm_params` string, nullable: Algorithm parameter
- `categorical` boolean, nullable: Return statistics for categorical dataset. Defaults to `False`
- `c` union[], nullable: List of values for which to report counts.
  - union
    - number
    - integer
- `p` integer[], nullable: List of percentile values (default to [2, 98]).
- `histogram_bins` string, nullable: Defines the number of equal-width bins in the given range (10, by default). If bins is a sequence (comma `,` delimited values), it defines a monotonically increasing array of bin edges, including the rightmost edge, allowing for non-uniform bin widths. link: https://numpy.org/doc/stable/reference/generated/numpy.histogram.html
- `histogram_range` string, nullable: Comma `,` delimited range of the bins. The lower and upper range of the bins. If not provided, range is simply (a.min(), a.max()). Values outside the range are ignored. The first element of the range must be less than or equal to the second. range affects the automatic bin computation as well. link: https://numpy.org/doc/stable/reference/generated/numpy.histogram.html

## Response `200`

Return dataset's statistics.

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/chloris/apis/chloris-geospatial-s-dynamic-tiler.md) - [All operations](https://skmtc.dev/chloris/apis/chloris-geospatial-s-dynamic-tiler/llms.txt) - [OpenAPI document](https://skmtc.dev/chloris/apis/chloris-geospatial-s-dynamic-tiler/revisions/8c654362f5b5?raw)