Stratification Data Orders

This page covers the two endpoints for checking on stratification orders you've already placed. See
OVERVIEW.mdx for the base URL, authentication, and response envelope shape. To place an order in
the first place, see STRATIFICATION_WORKFLOW.mdx.

Endpoints

Method	Path	Purpose
GET	`stratification/data-processing/orders/`	List orders
GET	`stratification/data-processing/orders/ORDER_ID/`	Retrieve an order

Required permission: stratification_order.view for both actions. Filter: aoi (exact match on AOI id).

Known issue — do not rely on this endpoint being read-only. Despite being designed and named as
list/retrieve-only, this endpoint's underlying implementation currently also accepts POST, PUT, PATCH, and
DELETE on the same paths, and — critically — those write methods have no permission-slug check at all, so any
authenticated, subscribed company user can create, modify, or delete stratification data order records
directly, bypassing the wallet charge and once-per-year-per-AOI limit that the normal place-order flow
enforces (see STRATIFICATION_WORKFLOW.mdx). This is a tracked bug rather than
intended behavior. Until it's fixed: do not build integration code that relies on write access to this endpoint
being blocked, and do not document or rely on these write methods as a supported way to manage orders — treat
this endpoint as list/retrieve only in your own integration even though the server currently accepts more.

Response fields

A standard order record includes a nested aoi object, a writable aoi_id, status, and other standard
timestamp fields. This section is kept brief since the primary use of this endpoint is just checking on an order
you already placed via place-order.

Status codes

Status	Trigger
200	Success.
403	Missing `stratification_order.view`.
404	Order not found.

Example

curl "https://backend.spacenus.de/api/v1.2/sat-mrv/stratification/data-processing/orders/?aoi=AOI_ID" \
  -H "Authorization: Bearer YOUR_TOKEN"

Response:

{
  "status": "success",
  "message": "Operation successful.",
  "data": [
    {
      "id": 214,
      "data_uuid": "DATA_UUID",
      "status": "active",
      "request_date": "2026-07-01",
      "request_by": {
        "id": 8,
        "email": "[email protected]"
      },
      "total_time": 342,
      "total_saved_stratification_maps": 1,
      "total_saved_sample_plan_maps": 1,
      "aoi": {
        "id": 55,
        "aoi_uuid": "AOI_UUID",
        "name": "North Field Cluster"
      },
      "company": 30,
      "created_at": "2026-07-01T09:12:03Z",
      "updated_at": "2026-07-01T09:47:51Z"
    }
  ]
}