---
title: "Place an ELVIS Australian-elevation order over an AOI; the delivery auto-ingests into the project."
method: POST
path: "/v1/op/catalog.elvis.order"
tags: ["kernel-ops"]
---

# Place an ELVIS Australian-elevation order over an AOI; the delivery auto-ingests into the project.

`POST /v1/op/catalog.elvis.order`

## Headers

- `x-api-key` string, nullable

## Request body

- ElvisOrderInput
  - `project_id` string, required — Project the delivery ingests into (rides the reply-to address).
  - `bbox` number[], nullable — AOI [west, south, east, north] (WGS84).
  - `intersects` object, nullable — AOI GeoJSON Polygon (alternative to bbox).
  - `industry` string, nullable — ELVIS 'industry' field (default 'Other').
  - `out_coord_sys` string — Output CRS code for transformable datasets ("" = native).
  - `out_format` string — Output format code for transformable datasets ("" = native).
  - `email_override` string, nullable — Override the delivery email. DEFAULT routes to elvis-job-<project_id>@inbound so the delivery auto-ingests — only override to send the link to a human instead.
  - `products` string[], nullable — Restrict the order to these ELVIS product types (case-insensitive), e.g. ["Point Clouds"] or ["Digital Elevation Models"]. DEFAULT orders everything available over the AOI — which can be ~40 tiles incl. whole-of-Australia DEM products. Use `available_products` from a prior call (or catalog.elvis.downloadables) to see options.
  - `max_tiles` integer, nullable — Cap the total number of tiles ordered (size/cost/turnaround control). Default: no cap. Combine with `products` to order, say, just the nearest point-cloud tile.
  - `file_names` string[], nullable — Order EXACTLY these tiles by ELVIS file_name (the per-tile selection from the portal's 'Add to My Data' tray — each ELVIS search result's id IS its file_name). The tiles are still re-sourced from live availability over the AOI so their fields are ELVIS-valid; only file_names that exist over the AOI are ordered. None = order all available (subject to products/max_tiles).

## Response `200`

Successful Response

- ElvisOrderOutput
  - `request_id` string, required
  - `delivery_email` string, required
  - `polygon` string, required
  - `dataset_blocks` integer, required
  - `tile_count` integer, required
  - `products_ordered` string[], required
  - `available_products` object, required
  - `auto_ingest` boolean, required
  - `status` string

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.dev/geopera/apis/geopera-data-platform.md) · [All operations](https://skmtc.dev/geopera/apis/geopera-data-platform/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/geopera/geopera-data-platform/revisions/cb0130b2a40a/schema)