---
title: "Retrieve a list of harvest activities"
method: GET
path: "/v4/layers/asHarvested"
tags: ["Layers"]
---

# Retrieve a list of harvest activities

`GET /v4/layers/asHarvested`

## Request

- Base URL: `https://platform.climate.com`
- URL: `https://platform.climate.com/v4/layers/asHarvested`
- Auth: one of:
  - API key in header `X-Api-Key`
  - OAuth 2
    - Authorization code: `https://climate.com/static/app-login/`
    - Token URL: `https://api.climate.com/api/oauth/token` scopes: `platform`, `asHarvested:read`
- TypeScript: <https://skmtc.dev/fieldview/apis/climate-fieldview-platform-apis/docs/v4/layers/asHarvested/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a list of harvest activities. The id in the response is used for  GET /v4/layers/asHarvested/{activityId}/contents.

## Query parameters

- `resourceOwnerId` string, uuid
- `occurredAfter` string, date-time
- `occurredBefore` string, date-time
- `updatedAfter` string, date-time

## Headers

- `Accept` string, required
- `X-Next-Token` string
- `X-Limit` integer

## Response `200`

OK

- HarvestActivities: A batch of harvest activities
  - `results` HarvestActivitySummary[], required
    - `id` string, uuid, required: The id of a harvest activity.
    - `startTime` string, date-time, required: The start time of the harvest activity. 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 harvest activity. Time in ISO 8601 format with UTC timezone, 3 fractional seconds (https://tools.ietf.org/html/rfc3339).
    - `createdAt` string, date-time, required: The time the harvest activity was created. 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 harvest activity was last updated. Time in ISO 8601 format with UTC timezone, 3 fractional seconds. (https://tools.ietf.org/html/rfc3339).
    - `length` integer, required: The size in bytes of the raw harvest activity file.
    - `fieldIds` string[], required: Array of field ids associated the harvest activity.

## Other responses

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

---

[API](https://skmtc.dev/fieldview/apis/climate-fieldview-platform-apis.md) - [All operations](https://skmtc.dev/fieldview/apis/climate-fieldview-platform-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/fieldview/apis/climate-fieldview-platform-apis/revisions/f6831695600e?raw)