---
title: "Add a GEDI/ICESat lidar granule to a project as an owned COPC point cloud (free, async)."
method: POST
path: "/v1/catalog/gedi/acquire"
tags: ["resource-facade"]
---

# Add a GEDI/ICESat lidar granule to a project as an owned COPC point cloud (free, async).

`POST /v1/catalog/gedi/acquire`

## Headers

- `x-api-key` string, nullable

## Request body

- GediAcquireInput
  - `project_id` string, required — Project the point cloud is ingested into.
  - `collection` string, required — Registry collection id, e.g. GEDI02_A.v002 or ATL08_007
  - `href` string, required — HTTPS .h5 granule URL from the STAC item (Earthdata-hosted)
  - `bbox` number[], required — AOI [west, south, east, north] (WGS84) to subset on
  - `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 My Data item
  - `max_points` integer — Uniform-subsample ceiling

## Response `200`

Successful Response

- GediAcquireOutput
  - `job_id` string, nullable
  - `status` string, required
  - `collection` string, required
  - `name` string, required

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