---
title: "Subset an EDL-gated lidar granule to the AOI and ingest it as a per-org COPC point cloud."
method: POST
path: "/v1/acquire/gedi"
tags: ["resource-facade"]
---

# Subset an EDL-gated lidar granule to the AOI and ingest it as a per-org COPC point cloud.

`POST /v1/acquire/gedi`

## Headers

- `x-api-key` string, nullable

## Request body

- AcquireGediInput
  - `params` GediAcquireParams
    - `collection` string, required — Registry collection id, e.g. GEDI02_A.v002 or ATL08_007
    - `href` string, required — HTTPS .h5 granule URL (Earthdata-hosted)
    - `bbox` number[], required — AOI [west, south, east, north] (WGS84)
    - `clip_polygon` object, nullable — AOI GeoJSON Polygon/MultiPolygon — clip to the exact shape, not just the bbox
    - `name` string, nullable — Display name for the resulting item
    - `max_points` integer — Uniform-subsample ceiling
  - `project_id` string, nullable
  - `item_ids` string[]

## Response `200`

Successful Response

- ProcessRunResult — The uniform result shape every projected process returns. `status` is 'completed' for an inline run (outputs ready now) or 'dispatched' for an async runtime (poll job_id via processing.job.get / processing.job.wait).
  - `process_id` string, required
  - `status` string, required
  - `job_id` string, nullable
  - `input_count` integer
  - `outputs` ProcessOutputRef[]
    - `kind` string, required
    - `key` string, required
    - `item_id` string, required
    - `asset_id` string, nullable

## 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)