List Files

View Markdown

Get a paginated list of your files.


GET
/files

Authorization

AuthorizationRequiredBearer <token>

See API Security for more details.

In: header

Query Parameters

pageinteger
Default: 1Minimum: 1
limitinteger
Default: 20Minimum: 1Maximum: 100

Header Parameters

Accept-Versionstring

Specifies the API Version

Default: "2025-08-20"Value in: "2025-08-20" | "latest"

Response Body

Success

responseRequiredarray<object>
const files = await fetch("https://api.ittybit.com/files", {
  headers: { "Authorization": "Bearer ITTYBIT_API_KEY" }
})
[
  {
    "id": "file_abcdefgh1234",
    "media_id": "med_abcdefgh1234",
    "object": "source",
    "kind": "video",
    "type": "video/mp4",
    "width": 1920,
    "height": 1080,
    "duration": 123.45,
    "filesize": 12345678,
    "filename": "file_abcdefgh1234.mp4",
    "url": "https://you.ittybit.net/file_abcdefgh1234.mp4",
    "metadata": {
      "customKey": "your custom value"
    },
    "created": "2025-01-01T01:23:45Z",
    "updated": "2025-01-01T01:23:45Z",
    "status": "ready"
  },
  "… 19 more files"
]