# Stack rasters

| **Description** | Retrieves a tif or png file of the styled raster stack.  |
| --------------- | -------------------------------------------------------- |
| **Endpoint**    | `/path/raster/timestamp/stack/{z}/{x}/{y}?token={token}` |
| **Method**      | GET                                                      |

### Access Level Rules

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

### Processing Units

| **Minimum processing units** | 1 |
| ---------------------------- | - |

## Parameters

<table><thead><tr><th width="354">Name</th><th width="212">Description</th><th width="134">Required</th><th>Default</th></tr></thead><tbody><tr><td><code>stack</code></td><td>An array of JSONs. Each JSON should have properties "pathId", "timestampId" and "bandNumber". The mentioned bands will be stacked in the order they are in the array.</td><td>true</td><td></td></tr><tr><td><code>style</code></td><td>An id of a style to apply or an object describing a valid style. <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>true</td><td></td></tr><tr><td>x</td><td>The x coordinate of the tile.</td><td>true</td><td></td></tr><tr><td>y</td><td>The y coordinate of the tile.</td><td>true</td><td></td></tr><tr><td>z</td><td>The zoom level of the tile.</td><td>true</td><td></td></tr><tr><td><code>token</code></td><td>User’s login token. </td><td>false, token can also be passed in through the authorization header</td><td>Default null.</td></tr><tr><td><code>mask</code></td><td>A geojson polygon in wgs84 coordinates to mask the stack.</td><td>false</td><td>Default null.</td></tr></tbody></table>

Example of a valid stack request

```
// example of a valid stack:
stack=[
        {"pathId": "69661175-6aa6-4258-8114-f3f4093561ca", "timestampId": "e2233ac8-5357-48bd-a785-694af842e48e", "bandNumber": 1},
        {"pathId": "848b0931-62a3-41eb-a3c7-4c8203313381", "timestampId": "2c7ffef4-b906-4a64-921a-7e3493c6739e", "bandNumber": 1}
    ]
```

This creates a raster with two bands. Each band coming from the specified band, timestamp and layer combination.

{% hint style="info" %}
Mind that the stack is only defined in places where all the bands making up the stack are defined. All other location will be transparent. **If the referenced bands do not intersect anywhere there visualization will be transparent everywhere!**
{% endhint %}

A valid style for the above mentioned stack would be:

```
{
        "method":"formula",
        "name":"Visualization of my stack"
        "parameters":{      
          "formula": "band2 - band1",
          "alpha": 1,
          "continuous": true,
          "transitionPoints":[{"color":"#2A5C84","value":25},{"color":"#74AE56","value":129.5},{"color":"#FFE733","value":234},{"color":"#FF8C01","value":338.5},{"color":"#ED2938","value":443}]
    }
}


```

This visualizes the difference between the first and second band in the stack.

See [here](/developers/api-v3/path-raster/styles.md) to find how to create a style object.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ellipsis-drive.com/developers/api-v3/path-raster/timestamps/stack-rasters.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.