Fusara
Runs
Markdown ↗

List runs

GET/api/v3/run

Overview

Accepted v3 runs belonging to the authenticated API owner, across their API keys. Fixed pages of up to 100 runs ordered by created_at descending, then id descending. Follow next (older) or previous (newer) URLs unchanged with API authentication; unavailable links are omitted. Cursors retain filters, expire 24 hours after the first page, and exclude new head entries; statuses, costs and availability remain live. Invalid/foreign cursors return 422 invalid_cursor, expired cursors return 410 cursor_expired. Empty history returns data: []. List outputs are descriptors with usable media URLs and expiry, without large inline text/JSON; GET /api/v3/run/{id} returns full results.

Requires an API key. Send Authorization: Bearer YOUR_API_KEY. Authentication →

curl 'https://fusara.ai/api/v3/run?status=succeeded&model=qwen-image21-create' \
  -H "Authorization: Bearer $FUSARA_API_KEY"

Parameters

modelstring

Exact public model ID, including its variant. Historical disabled models remain searchable.

  • query
statusstring

Distinct comma-separated statuses: queued, running, succeeded, failed, canceled. Values are OR; different filters are AND.

  • query
created_fromstring

Inclusive RFC 3339 creation timestamp with an explicit timezone (up to seven fractional digits).

  • query
created_tostring

Exclusive RFC 3339 creation timestamp. Must be later than created_from.

  • query
idsstring

Up to 100 distinct positive run IDs, comma-separated. Only accessible matches are returned, newest first.

  • query
cursorstring

Opaque continuation token from a returned link. Cannot be combined with other query parameters.

  • query

Responses

OK

Illustrative response. Prices, IDs and URLs come from your own request.

Example response
{
  "data": [
    {
      "id": 123456,
      "status": "succeeded",
      "cost": {
        "unit": "common_fuz",
        "expected": "40.0000",
        "status": "settled",
        "charged": "40.0000"
      },
      "outputs": [
        {
          "type": "image",
          "media_id": 901,
          "url": "https://media.example/result.png",
          "url_expires_at": "2026-10-25T12:00:00Z"
        }
      ],
      "model": "qwen-image21-create",
      "created_at": "2026-10-24T12:00:00Z"
    }
  ]
}
dataobject[]required

Up to 100 accepted v3 runs, newest first. An empty history is an empty array.

Nested fields 7
idintegerrequired
  • Format: int64
  • Minimum: 0
  • Maximum: 4294967295
modelstringrequired
statusstringrequired
created_atstringrequired
  • Format: date-time
costobjectrequired
Nested fields 4
unitstringrequired

Billing unit: common_fuz.

expectedstringrequired

Total accepted estimate for this run, as a decimal string.

statusstringrequired

pending until billing is confirmed, then settled. Generation can finish before settlement.

chargedstring

Confirmed final charge, as a decimal string. Omitted while pending; confirmed zero is 0.0000.

outputsobject[]
Nested fields 6
typestringrequired
media_idinteger

Reusable account media ID when this output is a file.

  • Format: int64
  • Minimum: 0
  • Maximum: 4294967295
urlstring

Download URL when the file is available. Save it before url_expires_at.

url_expires_atstring

UTC expiry of this output URL, when provided.

  • Format: date-time
expiredboolean

True when the media is no longer available; its dead URL is omitted.

model_asset_idinteger
  • Format: int64
  • Minimum: 0
  • Maximum: 4294967295
errorobject
Nested fields 2
codestringrequired

Machine-readable generation failure code.

messagestringrequired

Human-readable explanation of the generation failure.

nextstring

Absolute URL for older matches. Follow unchanged with API authentication. Omitted at the end.

previousstring

Absolute URL for newer matches. Follow unchanged with API authentication. Omitted when unavailable.

Response headers

X-Request-Idstringrequired

Support/trace identifier for this HTTP request.