GET

Get File Descriptor


Gets information about a specific file in the Media Manager.

Authentication

You can only call this method when authenticated as a Wix app or Wix user identity.

Permissions
Manage Bookings Services and Settings
Manage Media Manager
Read Media Manager
Manage Portfolio
Manage Restaurants - all permissions
Learn more about app permissions.
Endpoint
GET
https://www.wixapis.com/site-media/v1/files/get-file-by-id

Query Params
fileIdstringRequired

File ID.

You can also specify the file's Wix media URL. For example, wix:image://v1/0abec0_b291a9349a0b4da59067f76287e386fb~mv2.jpg/leon.jpg#originWidth=3024&originHeight=4032. Learn more about the file ID parameter (SDK | REST).

If you are working in REST, note that you must encode the Wix media URL to specify it as a query param because it contains special characters. For example, wix:image://v1/0abec0_b291a9349a0b4da59067f76287e386fb~mv2.jpg/leon.jpg#originWidth=3024&originHeight=4032 becomes wix%3Aimage%3A%2F%2Fv1%2F0abec0_b291a9349a0b4da59067f76287e386fb~mv2.jpg%2Fleon.jpg%23originWidth%3D3024%26originHeight%3D4032.

Response Object
fileFile

Information about the file.

Get information about a file
Request
cURL
curl -X GET \ 'https://www.wixapis.com/site-media/v1/files/get-file-by-id?fileId=4acbb8_5646ee01a5524905af4f2e7c567cbbce' \ -H 'Authorization: <AUTH>'
Response
JSON
{ "file": { "id": "4acbb8_5646ee01a5524905af4f2e7c567cbbce", "displayName": "sample-mpg-file.mpg", "url": "https://video.wixstatic.com/video/4acbb8_5646ee01a5524905af4f2e7c567cbbce/file", "parentFolderId": "media-root", "hash": "6f9dad8f467c579269d96fdb4f7c95cd", "sizeInBytes": "5918720", "private": false, "mediaType": "VIDEO", "media": { "video": { "id": "4acbb8_5646ee01a5524905af4f2e7c567cbbce", "resolutions": [ { "url": "https://video.wixstatic.com/video/4acbb8_5646ee01a5524905af4f2e7c567cbbce/240p/mp4/file.mp4", "height": 240, "width": 320, "poster": null, "format": "mp4", "urlExpirationDate": null, "sizeInBytes": null, "quality": "240p", "filename": null }, { "url": "https://files.wix.com/site/media/video/4acbb8_5646ee01a5524905af4f2e7c567cbbce/bee66e94-91b6-4ff2-b0b8-236c95361027/repackage/hls", "height": 0, "width": 0, "poster": null, "format": "hls", "urlExpirationDate": null, "sizeInBytes": null, "quality": null, "filename": null }, { "url": "https://video.wixstatic.com/video/4acbb8_5646ee01a5524905af4f2e7c567cbbce/storyboard/144p/mp4/file.mp4", "height": 144, "width": 192, "poster": null, "format": "mp4", "urlExpirationDate": null, "sizeInBytes": null, "quality": "144p", "filename": null } ], "filename": "sample-mpg-file.mpg", "url": "https://video.wixstatic.com/video/4acbb8_5646ee01a5524905af4f2e7c567cbbce/file", "posters": [ { "id": "", "url": "https://static.wixstatic.com/media/4acbb8_5646ee01a5524905af4f2e7c567cbbcef000.jpg", "height": 240, "width": 320, "altText": null, "urlExpirationDate": null, "filename": null, "sizeInBytes": null }, { "id": "", "url": "https://static.wixstatic.com/media/4acbb8_5646ee01a5524905af4f2e7c567cbbcef001.jpg", "height": 240, "width": 320, "altText": null, "urlExpirationDate": null, "filename": null, "sizeInBytes": null }, { "id": "", "url": "https://static.wixstatic.com/media/4acbb8_5646ee01a5524905af4f2e7c567cbbcef002.jpg", "height": 240, "width": 320, "altText": null, "urlExpirationDate": null, "filename": null, "sizeInBytes": null }, { "id": "", "url": "https://static.wixstatic.com/media/4acbb8_5646ee01a5524905af4f2e7c567cbbcef003.jpg", "height": 240, "width": 320, "altText": null, "urlExpirationDate": null, "filename": null, "sizeInBytes": null } ], "sizeInBytes": "5918720", "urlExpirationDate": null } }, "operationStatus": "READY", "sourceUrl": null, "thumbnailUrl": "https://static.wixstatic.com/media/4acbb8_5646ee01a5524905af4f2e7c567cbbcef002.jpg", "labels": [], "createdDate": "2022-08-21T15:39:09Z", "updatedDate": "2022-08-21T15:39:21Z", "state": "OK" } }
Errors
400Invalid Argument

There is 1 error with this status code.

This method may also return standard errors. Learn more about standard Wix errors.

Did this help?