Skip to main content
GET
/
v1
/
file_uploads
/
{file_upload_id}
TypeScript SDK
import { Client } from "@notionhq/client"

const notion = new Client({ auth: process.env.NOTION_API_KEY })

const response = await notion.fileUploads.retrieve({
  file_upload_id: "a02fc1d3-db8b-45c5-a222-27595b15aea7"
})
{
  "object": "<string>",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_time": "2023-12-25",
  "created_by": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "type": "person"
  },
  "last_edited_time": "2023-12-25",
  "archived": true,
  "expiry_time": "2023-12-25",
  "status": "pending",
  "filename": "<string>",
  "content_type": "<string>",
  "content_length": 1,
  "upload_url": "<string>",
  "complete_url": "<string>",
  "file_import_result": {
    "imported_time": "2023-12-25",
    "type": "<string>",
    "success": {}
  },
  "number_of_parts": {
    "total": 1,
    "sent": 1
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Notion-Version
enum<string>
required

The API version to use for this request. The latest version is 2025-09-03.

Available options:
2025-09-03

Path Parameters

file_upload_id
string
required

Identifier for a Notion file upload object.

Response

object
string
required

Always file_upload

Allowed value: "file_upload"
id
string<uuid>
required
created_time
string<date>
required
created_by
object
required
last_edited_time
string<date>
required
archived
boolean
required
expiry_time
string<date> | null
required
status
enum<string>
required

One of: pending, uploaded, expired, failed

Available options:
pending,
uploaded,
expired,
failed
filename
string | null
required
content_type
string | null
required
content_length
integer | null
required
Required range: x >= 0
upload_url
string
complete_url
string
file_import_result
object
number_of_parts
object