---
title: "Get latest data harvest"
method: GET
path: "/users/@me/harvest/latest"
tags: ["Users"]
---

# Get latest data harvest

`GET /users/@me/harvest/latest`

## Request

- Base URL: `https://web.fluxer.app/api/v1`
- URL: `https://web.fluxer.app/api/v1/users/@me/harvest/latest`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/fluxer/apis/fluxer-api/docs/users/@me/harvest/latest/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves the status of the most recent data harvest request. Returns null if no harvest has been requested yet. Shows progress and estimated completion time.

## Response `200`

Success

- HarvestStatusResponseSchemaNullable, nullable
  - `harvest_id` string, snowflake, required
  - `status` 'pending' | 'processing' | 'completed' | 'failed', required: Current status of the harvest request
  - `created_at` string, required: ISO 8601 timestamp when the harvest request was created
  - `started_at` string, nullable, required: ISO 8601 timestamp when the harvest started, or null if pending
  - `completed_at` string, nullable, required: ISO 8601 timestamp when the harvest completed, or null otherwise
  - `failed_at` string, nullable, required: ISO 8601 timestamp when the harvest failed, or null otherwise
  - `file_size` string, nullable, required: Final file size of the downloaded data, expressed as a string, or null if not available
  - `progress_percent` number, required: Harvest progress as a percentage value between 0 and 100
  - `progress_step` string, nullable, required: Textual description of the current harvest step, if available
  - `error_message` string, nullable, required: Error message when the harvest fails, or null otherwise
  - `download_url_expires_at` string, nullable, required: ISO 8601 timestamp when the download URL expires, or null if unavailable
  - `expires_at` string, nullable, required: ISO 8601 timestamp when the harvest download expires, or null if unavailable

## Other responses

- `400`: Bad Request - The request was malformed or contained invalid data
- `401`: Unauthorized - Authentication is required or the token is invalid
- `403`: Forbidden - You do not have permission to perform this action
- `429`: Too Many Requests - You are being rate limited
- `500`: Internal Server Error - An unexpected error occurred

## Changes

> 67 revisions in range; 2 not diffed.

- **2026-09-18** `dd0ad4ea1c88`: 8 breaking, 8 info
  - the response property `anyOf[subschema #1]/completed_at` became nullable for the status `200`
  - the response property `anyOf[subschema #1]/download_url_expires_at` became nullable for the status `200`
  - the response property `anyOf[subschema #1]/error_message` became nullable for the status `200`
  - the response property `anyOf[subschema #1]/expires_at` became nullable for the status `200`
  - …12 more
- **2026-09-06** `a52a2cf49d9b`: 32 warning
  - added the new `IP_BAN_DECLINED` enum value to the `code` response property for the response status `400`
  - added the new `IP_BAN_DECLINED` enum value to the `code` response property for the response status `401`
  - added the new `IP_BAN_DECLINED` enum value to the `code` response property for the response status `403`
  - added the new `IP_BAN_DECLINED` enum value to the `code` response property for the response status `500`
  - …28 more
  - …this revision’s changelog is incomplete
- …earlier changes not shown

[Operation history](https://skmtc.dev/fluxer/apis/fluxer-api/changes/users/@me/harvest/latest/get.md)

---

[API](https://skmtc.dev/fluxer/apis/fluxer-api.md) - [All operations](https://skmtc.dev/fluxer/apis/fluxer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fluxer/apis/fluxer-api/revisions/c3e0298c2255?raw)