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-11-07T05:31:56Z",
  "created_by": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "type": "person"
  },
  "last_edited_time": "2023-11-07T05:31:56Z",
  "in_trash": true,
  "expiry_time": "2023-11-07T05:31:56Z",
  "status": "pending",
  "filename": "<string>",
  "content_type": "<string>",
  "content_length": 1,
  "upload_url": "<string>",
  "complete_url": "<string>",
  "file_import_result": {
    "imported_time": "2023-11-07T05:31:56Z",
    "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 2026-03-11.

Available options:
2026-03-11

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-time>
required
​
created_by
object
required
​
last_edited_time
string<date-time>
required
​
in_trash
boolean
required
​
expiry_time
string<date-time> | 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
Success · object
​
number_of_parts
object