---
title: "Deterministic imagery plan for one event"
method: GET
path: "/api/v1/collection/plan"
---

# Deterministic imagery plan for one event

`GET /api/v1/collection/plan`

## Request

- Base URL: `https://offnadir-delta.com`
- URL: `https://offnadir-delta.com/api/v1/collection/plan`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Costs 4 token(s) per request (it deliberately issues two catalog searches). The SERVER decides which collections to search for the stated goal — sentinel-1-grd (SAR: all-weather, survives cloud and night) and sentinel-2-l2a (optical) exactly once each — against the event's own footprint and a pre/post window around its date, so the all-weather look can never be silently skipped and the same search is never repeated. Per search it reports why it was made, scenes returned, how many actually COVER the event and are usable (cloud-obscured optical does not count), the SAR pair status and whether a pre/post bracket exists, plus screening / detection / identification capability — a VHR recommendation never invalidates what the free catalog already showed. The vhr_recommendation.assessed flag says whether the VHR question was DECIDED at all: when the subject has no recorded ground-sampling requirement it comes back false, and recommended:false then means "not determined", NOT "not needed". An event with no resolvable footprint is refused rather than planned against a guess.

## Query parameters

- `event_id` string, uuid, required
- `analysis_goal` 'damage_assessment' | 'flood_mapping' | 'wildfire_assessment', required
- `event_date` string, date

## Response `200`

The executed plan, one step per collection.

- object
  - `meta` object
  - `plan` object

## Other responses

- `400` (unresolved $ref)
- `401` (unresolved $ref)
- `402` (unresolved $ref)
- `404` (unresolved $ref)
- `429` (unresolved $ref)

---

[API](https://skmtc.dev/offnadir-delta/apis/off-nadir-delta-api.md) · [All operations](https://skmtc.dev/offnadir-delta/apis/off-nadir-delta-api/llms.txt) · [OpenAPI document](https://skmtc.dev/offnadir-delta/apis/off-nadir-delta-api/revisions/5cf3f2bed5a2?raw)