Orders

Validate external file URL

Pre-flight check of an audio file by link, without creating an order: the file is fetched, its duration measured, and the speech and content checks an order goes through are run on it. A check that cannot run on our side is reported as unavailable (available: false, a null finding) and never makes the file invalid. A link that cannot be fetched, a file over 750 MB or audio that cannot be read answers 400 with valid: false and an error code. Not offered until the account email is confirmed (403 email_verification_required): submit directly, the same checks run and nothing is charged if the audio is refused.

post/orders/validate

Request

  • Base URL: https://barevalue.com/api/v1
  • URL: https://barevalue.com/api/v1/orders/validate
  • Auth: HTTP bearer

Request body

file_urlstring uri required

Public URL of the audio file to validate

Response

Validation result

validboolean

false only when a check that ran found the file unsuitable. A check that could not run never makes the file invalid.

duration_minutesnumber

Duration of the audio in minutes, to two decimals.

messagestring

Present when valid is false: why the file was found unsuitable.

Changes

No recorded changes to this operation across all 1 revision of this API.