---
title: "Retrieve a list of scouting observations"
method: GET
path: "/v4/layers/scoutingObservations"
tags: ["Layers"]
---

# Retrieve a list of scouting observations

`GET /v4/layers/scoutingObservations`

Retrieve a list of scouting observations created or updated by the user identified by the Authorization header.

## Query parameters

- `occurredAfter` string, date-time
- `occurredBefore` string, date-time

## Headers

- `X-Next-Token` string
- `X-Limit` integer

## Response `200`

OK

- ScoutingObservations — A batch of scouting observations
  - `results` ScoutingObservationSummary[], required
    - `id` string, uuid, required — The id of a scouting observation.
    - `startTime` string, date-time, required — The start time of the scouting observation. Time in ISO 8601 format with UTC timezone, 3 fractional seconds (https://tools.ietf.org/html/rfc3339).
    - `endTime` string, date-time, required — The start time of the scouting observation. Time in ISO 8601 format with UTC timezone, 3 fractional seconds (https://tools.ietf.org/html/rfc3339).
    - `updatedAt` string, date-time, required — The time the scouting observation or any of its attachments was last updated.Time in ISO 8601 format with UTC timezone, 3 fractional seconds. (https://tools.ietf.org/html/rfc3339).

## Other responses

- `206` — Partial Result
- `304` — Not Modified
- `400` — Bad Input

---

[API](https://skmtc.net/fieldview/apis/climate-fieldview-platform-apis.md) · [All operations](https://skmtc.net/fieldview/apis/climate-fieldview-platform-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fieldview/climate-fieldview-platform-apis/revisions/f6831695600e/schema)