Stream request status

GET

{owner}

{app}

requests

{request_id}

status

stream

Stream request status

curl --request GET \
  --url https://queue.fal.run/{owner}/{app}/requests/{request_id}/status/stream \
  --header 'Authorization: <api-key>'

import requests

url = "https://queue.fal.run/{owner}/{app}/requests/{request_id}/status/stream"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://queue.fal.run/{owner}/{app}/requests/{request_id}/status/stream', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

data: {"status":"IN_PROGRESS","request_id":"019a1b2c-...","logs":null,"metrics":{}}

data: {"status":"COMPLETED","request_id":"019a1b2c-...","logs":null,"metrics":{"inference_time":1.82}}

{
  "detail": "<string>",
  "type": "<string>"
}

{
  "status": "NOT_FOUND"
}

Authorizations

Authorization

string

header

required

Send your fal API key in the Authorization header with the Key prefix, for example Authorization: Key $FAL_KEY. Public models also accept requests without a key. See Authentication.

Path Parameters

owner

string

required

The owner of the model, for example blackforestlabs. Use the same value as in the submit request.

app

string

required

The model app name, for example flux-3-max. Do not add the endpoint path. The status_url, response_url, and cancel_url fields contain the correct URL.

request_id

string<uuid>

required

The request ID that the submit response returned.

Query Parameters

logs

enum<string>

Set to 1 to include runner logs in the response. Logs are not available for all models.

Available options:

1,

0

Response

A stream of status events.

The response is of type string.

⌘I

Stream request status

curl --request GET \
  --url https://queue.fal.run/{owner}/{app}/requests/{request_id}/status/stream \
  --header 'Authorization: <api-key>'

import requests

url = "https://queue.fal.run/{owner}/{app}/requests/{request_id}/status/stream"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://queue.fal.run/{owner}/{app}/requests/{request_id}/status/stream', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

data: {"status":"IN_PROGRESS","request_id":"019a1b2c-...","logs":null,"metrics":{}}

data: {"status":"COMPLETED","request_id":"019a1b2c-...","logs":null,"metrics":{"inference_time":1.82}}

{
  "detail": "<string>",
  "type": "<string>"
}

{
  "status": "NOT_FOUND"
}

Queue API

Synchronous API

Stream request status

Authorizations

Path Parameters

Query Parameters

Response