Join us for our Developer Platform Hackathon, May 16-17. Apply now →
import { Client } from "@notionhq/client"
const notion = new Client({ auth: process.env.NOTION_API_KEY })
const response = await notion.fileUploads.list({
start_cursor: undefined,
page_size: 50
}){
"object": "<string>",
"next_cursor": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"has_more": true,
"results": [
{
"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
}
}
],
"type": "<string>",
"file_upload": {},
"request_status": {
"type": "complete",
"incomplete_reason": "<string>"
}
}Use this API to retrieve file uploads for the current bot connection, sorted by most recent first.
import { Client } from "@notionhq/client"
const notion = new Client({ auth: process.env.NOTION_API_KEY })
const response = await notion.fileUploads.list({
start_cursor: undefined,
page_size: 50
}){
"object": "<string>",
"next_cursor": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"has_more": true,
"results": [
{
"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
}
}
],
"type": "<string>",
"file_upload": {},
"request_status": {
"type": "complete",
"incomplete_reason": "<string>"
}
}Documentation Index
Fetch the complete documentation index at: https://developers.notion.com/llms.txt
Use this file to discover all available pages before exploring further.
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
The API version to use for this request. The latest version is 2026-03-11.
2026-03-11 If supplied, the endpoint will return file uploads with the specified status.
pending, uploaded, expired, failed If supplied, this endpoint will return a page of results starting after the cursor provided. If not supplied, this endpoint will return the first page of results.
The number of items from the full list desired in the response. Maximum: 100
1 <= x <= 100