FilesGet a file
Files

Get a file

Retrieves a file by its ID.

curl -X GET "https://api.fetchmedia.io/v1/files/123e4567-e89b-12d3-a456-426614174000" \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: YOUR_API_KEY"
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "file.mp4",
  "source": "upload",
  "status": "pending | running | success | failed",
  "created_at": "2024-12-25T10:00:00Z",
  "download_url": "https://api.fetchmedia.io/v1/files/123e4567-e89b-12d3-a456-426614174000/file.mp4",
  "error": "File processing failed: unsupported format",
  "ffprobe": {
    "width": 1920,
    "height": 1080,
    "duration": 120.5,
    "format_name": "mov,mp4,m4a,3gp,3g2,mj2"
  },
  "ffprobe_error": "ffprobe failed: invalid data found when processing input"
}
GET
/files/{id}
GET
API Key (header: X-API-KEY)
X-API-KEYstring
Required

API key (sent in header)

API Key (query: key)
keystring
Required

API key (sent in query)

Request Preview
Response

Response will appear here after sending the request

Authentication

header
X-API-KEYstring
Required

API Key for authentication. Provide your API key in the header.

query
keystring
Required

API Key for authentication. Provide your API key in the query.

Path Parameters

Responses

idstring

The ID of the file.

namestring

The name of the file.

sourcestring

The source of the file.

statusstring

The status of the file processing.

created_atstring

The creation time of the file.

download_urlstring

The URL of the file.

errorstring

The error message if the file processing failed.

ffprobeobject

The ffprobe of the file.

ffprobe_errorstring

The ffprobe error message if ffprobe failed.