GET/api/v1/files/uploads/{upload_id}

Check an upload

Where an upload stands: how many parts arrived and, once finished, whether the check passed (state is done, with result) or failed (failed, with error).

API token required240 per minute per IPMCP: get_upload_status

Code samples and Try it

Path parameters

upload_idstringRequired
The upload_id that Start a file upload returned.

Responses

200OK.
401No token, or the token is revoked or mistyped.
422The request didn't validate. detail lists each problem, with where it is (loc) and why (msg).
429Too many requests from your IP address. Wait the seconds in Retry-After.

200 response: 14 fields (UploadStatusResponse)

upload_idstring
statestring
file_namestring
content_typestring
size_bytesinteger
sha256string
part_sizeinteger
part_countinteger
parts_uploadedarray of object
3 fields inside
- part_numberinteger
- etagstring
- sizeinteger
target_slugstring | null
expires_atstring (date-time)
ISO 8601, for example 2026-11-30T12:00:00Z.
verified_bytesinteger | null
resultobject | null
9 fields inside
- urlstring
- markdrop_urlstring | null
- workspace_urlstring | null
- workspace_errorstring | null
- slugstring
- versioninteger
- size_bytesinteger
- content_typestring
- sha256string
errorstring | null

import os import requests r = requests.get( "https://api.markdrop.in/api/v1/files/uploads/UPLOAD_ID", headers={"Authorization": f"Bearer {os.environ['MARKDROP_TOKEN']}"}, ) r.raise_for_status() print(r.json())