---
title: "Initiate a new export request."
method: POST
path: "/v4/exports"
tags: ["Exports"]
---

# Initiate a new export request.

`POST /v4/exports`

Step one in requesting a data product. The method will return an **Export** ID which the caller will use in subsequent `GET` requests.
The following `contentTypes` may be requested:
  * __application/vnd.climate.acrsi.geojson__ (Beta)
     Exports the planting activities accessible by the authenticated user and optionally filtered by resource owner
     as a [GeoJSON Feature Collection](https://tools.ietf.org/html/rfc7946#page-12).

     The export request definition must contain the following properties:
       * plantingStartDate
       * plantingEndDate
       * resourceOwnerId

     Requires `exports:read` and `plantingActivitySummary:read` scope.
  
  * __application/vnd.climate.harvest.geojson__
     Exports the harvesting activities accessible by the authenticated user and optionally filtered by resource owner
     as a [GeoJSON Feature Collection](https://tools.ietf.org/html/rfc7946#page-12).

     The export request definition must contain the following properties:
       * harvestStartDate
       * harvestEndDate
       * resourceOwnerId

     Requires `exports:read` and `plantingActivitySummary:read` scope.
  
  * __application/vnd.climate.yield-analysis.pdf__
     Exports a PDF Yield Analysis Report (also called Harvest Summary Report) for all the fields in all the harvest seasons of the given year. If no year definition is provided then the current year is used.

     The export request definition can contain the following properties:
       * year

     Requires `exports:read` and `reports:read` scope.

  * __application/vnd.climate.yield-analysis.json__
     Exports a JSON Yield Analysis Report (also called Harvest Summary Report) for all the fields in all the harvest seasons of the given year. If no year definition is provided then the current year is used.

     The export request definition can contain the following properties:
       * year

     Requires `exports:read` and `reports:read` scope.

## Request body

- Export — Client request to export data from a user.
  - `contentType` 'application/vnd.climate.acrsi.geojson' | 'application/vnd.climate.harvest.geojson', mime-type, required — Content type representing data being exported (e.g. application/vnd.climate.acrsi.geojson).
  - `definition` object — Additional specifications for a client's data export request, dependent on the content type.

## Response `201`

OK

- CreatedExport
  - `id` string, uuid, required — Unique identifier for the export.

## Other responses

- `400` — Bad Input
- `401` — Unauthorized
- `403` — Forbidden
- `429` — Too Many Requests
- `500` — Internal Server Error
- `503` — Server Busy

---

[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)