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

# Bounds

`GET /tiles/cog/bounds`

## 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/bounds`
- Auth: API key in query parameter `access_token`
- TypeScript: <https://skmtc.dev/chloris/apis/chloris-geospatial-s-dynamic-tiler/docs/tiles/cog/bounds/get.ts> (a function with typed inputs; its response is checked against the schema)

Return the bounds of the COG.

## 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).
- `crs` string, nullable: Coordinate Reference System.

## Response `200`

Return dataset's bounds.

- Bounds: Dataset Bounding box
  - `bounds` unknown[], required
    - unknown
  - `crs` string, required

## 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)