> 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/order-api/list-images-order.md).

# GET Download images in order

## List order imagery

> Returns every image delivered against the order, as a GeoJSON FeatureCollection matching the image API. Each feature carries a \`links\` entry with the image download URL. An order whose imagery has not been delivered yet returns an empty collection.

```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."}},"schemas":{"ImageSearchResponse":{"type":"object","properties":{"type":{"type":"string","enum":["FeatureCollection"]},"features":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["Feature"]},"geometry":{"type":"object","properties":{"type":{"type":"string","enum":["Polygon"]},"coordinates":{"type":"array","items":{"type":"array","items":{}}}},"required":["type","coordinates"],"description":"Geographic area captured within the image (footprint)."},"properties":{"type":"object","properties":{"id":{"type":"string","description":"Encoded image identifier (SID)."},"key":{"type":"string","description":"Unique identifier for the image."},"url":{"type":"string","format":"uri","description":"S3 URL to the image."},"captureType":{"type":"string","description":"Type of image capture (e.g., panorama, orthomosaic, oblique)."},"heading":{"type":"number","description":"Camera heading in degrees [0, 360), 0 is north."},"pitch":{"type":"number","description":"Camera angle below horizontal in degrees [-135, 45], -90 is nadir."},"roll":{"type":"number","description":"Camera roll in degrees."},"altitude":{"type":"number","description":"Altitude above ground level in meters."},"tag":{"type":"string","description":"Optional tag for grouping images."},"attributes":{"type":"object","additionalProperties":{},"description":"Additional metadata stored as JSON."},"capturedAt":{"type":"string","description":"Timestamp when image was captured."},"processedAt":{"type":"string","description":"Timestamp when image was processed."},"cameraPosition":{"type":"object","properties":{"type":{"type":"string","enum":["Point"]},"coordinates":{}},"required":["type","coordinates"],"description":"2D point location of the camera at time of capture."},"distance":{"type":"number","description":"Distance in meters from the query point, with or without a radius (absent for bbox and polygon queries)."},"aoiPixelBounds":{"nullable":true,"description":"Pixel bounds of the area of interest within the original image, as [left, top, right, bottom] with the origin at the top-left. Always present when 'pixel_bounds' is requested, and null when there are no bounds."},"aoiPixelBoundsUnavailable":{"type":"boolean","description":"Always present when 'pixel_bounds' is requested. True when the bounds could not be computed for this image and False when the area of interest is not visible in this image."}},"required":["id","key","url","captureType","heading","pitch","roll","altitude","capturedAt","processedAt","cameraPosition"]},"links":{"type":"array","items":{"type":"object","properties":{"rel":{"type":"string","description":"Link relation type."},"href":{"type":"string","format":"uri","description":"URL of the linked resource."},"type":{"type":"string","description":"Media type of the linked resource."},"title":{"type":"string","description":"Human-readable title for the link."}},"required":["rel","href"]},"description":"Links to image variants."}},"required":["id","type","geometry","properties"]}},"next":{"type":"string","format":"uri","description":"URL to fetch the next page of results, if more exist."},"numberReturned":{"type":"number","description":"The number of features in the response."}},"required":["type","features","numberReturned"]}}},"paths":{"/developer-api/api/v1/order/{spexi_order_id}/images":{"get":{"description":"Returns every image delivered against the order, as a GeoJSON FeatureCollection matching the image API. Each feature carries a `links` entry with the image download URL. An order whose imagery has not been delivered yet returns an empty collection.","operationId":"OrderController_getOrderImages","parameters":[{"name":"spexi_order_id","required":true,"in":"path","description":"Spexi-assigned order identifier whose imagery to list.","schema":{"minLength":1,"type":"string"}},{"name":"limit","required":false,"in":"query","description":"Maximum number of images to return. The default is 100.","schema":{"minimum":1,"maximum":1000,"default":100,"type":"integer"}},{"name":"cursor","required":false,"in":"query","description":"Pagination token for retrieving subsequent result sets. Obtained from the `next` URL of a previous response.","schema":{"minLength":1,"type":"string"}}],"responses":{"200":{"description":"Images delivered against the order.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImageSearchResponse"}}}},"401":{"description":"Missing or invalid authentication credentials."},"403":{"description":"Caller lacks permission to access tasking orders."},"404":{"description":"No order matches the given `spexi_order_id` for the caller's organization."}},"summary":"List order imagery","tags":["Order"]}}}}
```