Soniox
Docs
API referenceREST APIFiles

Get file URL

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

GET
/v1/files/{file_id}/url

Headers

AuthorizationRequiredBearer <SONIOX_API_KEY>

Path parameters

file_idRequiredstring
Format: "uuid"

Response

200

File URL.

urlRequiredstring

Temporary file URL.

Errors

File URL.

{
  "url": "https://api.soniox.com/v1/files/84c32fc6-4fb5-4e7a-b656-b5ec70493753/download?token=TOKEN"
}

Authentication error.

{
  "status_code": 401,
  "error_type": "unauthenticated",
  "message": "Incorrect API key provided. You can get an API key at https://console.soniox.com",
  "validation_errors": [],
  "request_id": "3d37a3bd-5078-47ee-a369-b204e3bbedda"
}

File not found.

Error types:

  • file_not_found: File could not be found.

{
  "status_code": 400,
  "error_type": "file_not_found",
  "message": "File could not be found.",
  "validation_errors": [],
  "request_id": "3d37a3bd-5078-47ee-a369-b204e3bbedda"
}

Internal server error.

{
  "status_code": 500,
  "error_type": "internal_error",
  "message": "The server encountered an error. Please try again. If the issue persists contact support@soniox.com.",
  "validation_errors": [],
  "request_id": "3d37a3bd-5078-47ee-a369-b204e3bbedda"
}