Soniox
Docs
API reference/REST API/Files

Get file

Retrieve metadata for an uploaded file.

GET
/v1/files/{file_id}

Headers

AuthorizationRequiredBearer <SONIOX_API_KEY>

Path parameters

file_idRequiredstring
Format: "uuid"

Response

200

File metadata.

idRequiredstring

Unique identifier of the file.

Format: "uuid"
filenameRequiredstring

Name of the file.

sizeRequiredinteger

Size of the file in bytes.

created_atRequiredstring

UTC timestamp indicating when the file was uploaded.

Format: "date-time"
client_reference_idstring

Tracking identifier string.

Errors

File metadata.

{
  "id": "84c32fc6-4fb5-4e7a-b656-b5ec70493753",
  "filename": "example.mp3",
  "size": 123456,
  "created_at": "2024-11-26T00:00:00Z",
  "client_reference_id": "some_internal_id"
}

Delete file DELETE

Permanently deletes specified file.

Get file URL GET

Get a temporary file URL. URL is valid for 1 hour.