Batch-fetch lite video states

GET

/videos/batch

const url = 'https://api.devstreamcore.com/v1/videos/batch?ids=example';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api.devstreamcore.com/v1/videos/batch?ids=example' \
  --header 'Authorization: Bearer <token>'

Lite shape for polling many assets at once (max 50 ids).

Authorizations

ApiKey

Parameters

Query Parameters

ids

required

Comma-separated vid_* ids (max 50)

string

Comma-separated vid_* ids (max 50)

Responses

200

Lite states; unknown/foreign ids are omitted

application/json

object

data

required

Array<object>

object

required

string

status

required

string

Allowed values: preparing ready errored reprocessing

progress

required

number

transcode_attempts

required

number | null

duration

required

number | null

file_size_bytes

required

number | null

video_codec

required

string | null

fps

required

number | null

thumbnail_url

required

string | null

errors

required

Array<object>

object

type

required

string

messages

required

Array<string>

updated_at

required

string

Example

{
  "data": [
    {
      "status": "preparing"
    }
  ]
}

400

Invalid request

application/json

Error envelope — a single error per response.

object

error

required

object

type

required

string

Allowed values: invalid_request_error authentication_error permission_error not_found rate_limit_error quota_exceeded api_error

code

string

message

required

string

param

string

request_id

string

Example

{
  "error": {
    "type": "invalid_request_error"
  }
}

401

Missing or invalid API key

application/json

Error envelope — a single error per response.

object

error

required

object

type

required

string

Allowed values: invalid_request_error authentication_error permission_error not_found rate_limit_error quota_exceeded api_error

code

string

message

required

string

param

string

request_id

string

Example

{
  "error": {
    "type": "invalid_request_error"
  }
}

429

Rate limited — apply backoff

application/json

Error envelope — a single error per response.

object

error

required

object

type

required

string

Allowed values: invalid_request_error authentication_error permission_error not_found rate_limit_error quota_exceeded api_error

code

string

message

required

string

param

string

request_id

string

Example

{
  "error": {
    "type": "invalid_request_error"
  }
}