Skip to main content
GET
/
v1
/
file_uploads
TypeScript SDK
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-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
      }
    }
  ],
  "type": "<string>",
  "file_upload": {}
}

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

Query Parameters

status
enum<string>

If supplied, the endpoint will return file uploads with the specified status.

Available options:
pending,
uploaded,
expired,
failed
start_cursor
string

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.

page_size
integer

The number of items from the full list desired in the response. Maximum: 100

Required range: 1 <= x <= 100

Response

object
string
required

Always list

Allowed value: "list"
next_cursor
string<uuid> | null
required
has_more
boolean
required
results
object[]
required
type
string
required

Always file_upload

Allowed value: "file_upload"
file_upload
object
required