# Get raster

| **Description** | Retrieves raster for a given extent                            |
| --------------- | -------------------------------------------------------------- |
| **Endpoint**    | `/path/{pathId}/raster/timestamp/{timestampId}/rasterByExtent` |
| **Method**      | GET                                                            |

### Access Level Rules

| **Minimum Access Level** | view |
| ------------------------ | ---- |

### Processing Units

| **Minimum processing units** | 2 |
| ---------------------------- | - |

### Parameters

<table><thead><tr><th>Name</th><th>Description</th><th>Required</th><th>Default</th><th data-hidden>Type</th></tr></thead><tbody><tr><td>pathId</td><td>The id of the raster layer.</td><td>true</td><td></td><td></td></tr><tr><td>timestampId</td><td>The id of the timestamp to get the raster for.</td><td>true</td><td></td><td></td></tr><tr><td>extent</td><td>A JSON with properties "xMin", "xMax", "yMin" and "yMax" denotating the bounds of the image. The bounds need to be in epsg 3857.</td><td>true</td><td></td><td></td></tr><tr><td>width</td><td>Integer for the width of the image in pixels. Maximum of 2048.</td><td>true</td><td></td><td></td></tr><tr><td>height</td><td>Integer for the height of the image in pixels. Maximum of 2048.</td><td>true</td><td></td><td></td></tr><tr><td>bands</td><td>Array of integers containing the bands for which to retrieve data.</td><td>false</td><td>Default null.</td><td></td></tr><tr><td>style</td><td>An id of a style to apply or an object describing a valid style. If not given original raster values are returned.<br><br>Valid object for style can be found here: <a href="https://docs.ellipsis-drive.com/developers/api-v3/path-raster/styles/add-style">https://docs.ellipsis-drive.com/developers/api-v3/path-raster/styles/add-style</a></td><td>false</td><td>Default null.</td><td></td></tr><tr><td>mask</td><td>A GeoJSON geometry of type polygon or multiPolygon in WGS84 to apply as mask.</td><td>false</td><td>Default null.</td><td></td></tr><tr><td>applyStyle</td><td>Boolean indicating whether to style the tile. If true a PNG is returned if false the style is ignored and a tiff file is returned instead.</td><td>false</td><td>Default true.</td><td></td></tr></tbody></table>