> For the complete documentation index, see [llms.txt](https://learn.spexi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.spexi.com/api-reference/image-api/download-image.md).

# GET Download image

## Download image file

> Downloads an image with optional processing. Set 'zoom=true' to crop to the AOI. Requires 'aoi' parameter when zoom is enabled.

```json
{"openapi":"3.0.3","info":{"title":"Spexi Developer API","version":"1.0.0"},"servers":[{"url":"https://world.spexi.com","description":"Production"}],"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key passed via request header. Either this or the `api_key` query parameter is required."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"api_key","description":"API key passed as a query parameter. Either this or the `x-api-key` header is required."}}},"paths":{"/developer-api/api/v1/image/{imageId}/download":{"get":{"description":"Downloads an image with optional processing. Set 'zoom=true' to crop to the AOI. Requires 'aoi' parameter when zoom is enabled.","operationId":"ImageController_downloadImage","parameters":[{"name":"imageId","required":true,"in":"path","description":"Image identifier (SID format)","schema":{"minLength":1,"type":"string"}},{"name":"zoom","required":false,"in":"query","description":"Crop and zoom the image to the area of interest.","schema":{"default":false,"oneOf":[{"type":"boolean"},{"type":"string"}]}},{"name":"highlight","required":false,"in":"query","description":"Draw the AOI outline (or marker) on the image.","schema":{"default":false,"oneOf":[{"type":"boolean"},{"type":"string"}]}},{"name":"aoi","required":false,"in":"query","description":"Area of interest polygon in WKT format. Required if zoom is true.","schema":{"type":"string"}},{"name":"marker","required":false,"in":"query","description":"Point to mark instead of polygon outline. Format: lon,lat.","schema":{"pattern":"^-?\\d+(?:\\.\\d+)?,-?\\d+(?:\\.\\d+)?$","type":"string"}},{"name":"padding","required":false,"in":"query","description":"Zoom padding as a fraction (0.0 - 1.0). Default is 1.0 (100%).","schema":{"minimum":0,"maximum":1,"type":"number"}}],"responses":{"200":{"description":"Image file (JPEG)","content":{"image/jpeg":{}}},"422":{"description":"AOI does not intersect image footprint"}},"summary":"Download image file","tags":["Image"]}}}}
```