---
title: "Get upload history"
method: GET
path: "/uploadposts/history"
tags: ["Upload Management"]
---

# Get upload history

`GET /uploadposts/history`

Retrieve a paginated list of past uploads across all platforms, ordered most recent first.

## Query parameters

- `page` integer
- `limit` 10 | 20 | 50 | 100

## Response `200`

Upload history retrieved successfully.

- UploadHistoryResponse
  - `history` HistoryItem[]
    - `user_email` string
    - `profile_username` string
    - `platform` string
    - `media_type` 'video' | 'photo' | 'text'
    - `upload_timestamp` string, date-time
    - `success` boolean
    - `platform_post_id` string, nullable
    - `post_url` string, nullable
    - `error_message` string, nullable
    - `media_size_bytes` integer, nullable
    - `post_title` string, nullable
    - `post_caption` string, nullable
    - `is_async` boolean, nullable
    - `job_id` string, nullable — Present when the upload originated from a scheduled job.
    - `video_was_transcoded` boolean, nullable
    - `changes` string[], nullable — List of transformations applied to the media (e.g., transcoding, aspect ratio changes).
    - `prevalidation_metadata` object, nullable — Media metadata detected before upload (dimensions, codec, duration, etc.).
    - `request_id` string, nullable
    - `request_id_logs` string, nullable — Internal request ID for log correlation.
    - `request_total_platforms` integer, nullable
    - `dashboard` boolean, nullable — Whether the upload was initiated from the dashboard.
  - `total` integer
  - `page` integer
  - `limit` integer

## Other responses

- `400` — Bad Request — Missing or invalid parameters.
- `401` — Unauthorized — Invalid or expired token.
- `500` — Internal Server Error.

---

[API](https://skmtc.dev/upload-post/apis/upload-post-api.md) · [All operations](https://skmtc.dev/upload-post/apis/upload-post-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/upload-post/upload-post-api/revisions/10bd964e4415/schema)