---
title: "GET /scenes"
method: GET
path: "/scenes"
tags: ["Scenes"]
---

# GET /scenes

`GET /scenes`

Returns a paginated list of scene resources.

## Query parameters

- `provider` string, required
- `partyId` string, required
- `associatedResourceId` string, required
- `associatedResourceType` string, required
- `collection` string, required
- `itemId` string
- `startDateTime` string, date-time
- `endDateTime` string, date-time
- `maxCloudCoveragePercentage` number, double
- `maxDarkPixelCoveragePercentage` number, double
- `imageNames` string[]
- `imageResolutions` number[]
- `imageFormats` string[]
- `maxPageSize` integer
- `skipToken` string
- `api-version` string, required

## Response `200`

Success

- SceneListResponse — Paged response contains list of requested objects and a URL link to get the next set of results.
  - `value` Scene[], required — List of requested objects.
    - `sceneDateTime` string, date-time — Date-time of the scene, sample format: yyyy-MM-ddTHH:mm:ssZ.
    - `provider` string — Data provider of the scene.
    - `collection` string — Data collection of the scene.
    - `imageFiles` ImageFile[] — Collection of image files.
      - `fileLink` string — Link of the image file.
      - `name` string, required — Name of the image file.
      - `imageFormat` 'TIF' — Supported image formats for scene resource.
      - `resolution` number, double — Resolution of image file in meters.
    - `imageFormat` 'TIF' — Supported image formats for scene resource.
    - `itemId` string — ItemId to fetch scenes from sentinel hub.
    - `cloudCoverPercentage` number, double — Cloud cover percentage of the scene.
    - `darkPixelPercentage` number, double — Dark pixel percentage of the scene.
    - `ndviMedianValue` number, double — Median of NDVI of the scene.
    - `partyId` string — Party ID which belongs to the scene.
    - `id` string — Unique scene resource ID.
    - `eTag` string — The ETag value to implement optimistic concurrency.
    - `associatedResource` GeoResource — Schema for storing resource type and resource id.
      - `type` 'Field' | 'SeasonalField' | 'Zone' | 'Prescription' | 'PlantTissueAnalysis' | 'PlantingData' | 'ApplicationData' | 'HarvestData' | 'TillageData' — Resource Type.
      - `id` string — Resource Id.
  - `skipToken` string — Token used in retrieving the next page. If null, there are no additional pages.
  - `nextLink` string — Continuation link (absolute URI) to the next page of results in the list.

## Other responses

- `default` — Error

---

[API](https://skmtc.net/azure/apis/agrifood-agfoodplatform.md) · [All operations](https://skmtc.net/azure/apis/agrifood-agfoodplatform/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/agrifood-agfoodplatform/revisions/33cf1de6e0c4/schema)