list_results

GET /api/v2/results

Needs the results:read scope.

• Auth: API key (Authorization: Bearer)
• Key scope needed: results:read
• Raw spec: https://app.diffusr.ai/api/v2/openapi.json

Query

Name	Type	Required	Description
limit	integer	no	Default 20.

Example

cURL

curl "https://app.diffusr.ai/api/v2/results?limit=10" \
  -H "Authorization: Bearer $DIFFUSR_KEY"

TypeScript

import { Diffusr } from "diffusr";

const d = new Diffusr(); // reads DIFFUSR_KEY
const { results } = await d.listResults({ limit: 10 });
console.log(results.map((r) => r.status));

Python

from diffusr import Diffusr

d = Diffusr()  # reads DIFFUSR_KEY
data = d.list_results(limit=10)
print([r["status"] for r in data["results"]])

Response

200 ApiResultList

Your latest jobs, newest first.

Name	Type	Required	Description
results	object[]	yes	Newest first.
results[].id	string	yes
results[].status	“PENDING” | “RUNNING” | “SUCCEEDED” | “FAILED” | “CANCELED”	yes	PENDING and RUNNING = keep waiting. SUCCEEDED, FAILED and CANCELED are final.
results[].model	string	yes
results[].credits_estimated	number	no
results[].created_at	string	yes
results[].finished_at	string	no
results[].output	object	no	Present once SUCCEEDED.
results[].output.kind	“IMAGE” | “VIDEO” | “AUDIO”	yes
results[].output.url	string	yes	Public link to the file.
results[].output.thumbnail_url	string	no
results[].output.width	number	no
results[].output.height	number	no
results[].output.duration_sec	number	no
results[].error	object	no	Present when FAILED.
results[].error.code	string	yes
results[].error.message	string	yes
results[].request_id	string	no	The X-Request-Id of the request that started the job.
results[].test	true	no	true when a test key made the call: the price is real, nothing real ran. Absent for live keys.
results[].charge	object	yes
results[].charge.quoted_credits	number | null	yes	The most the call could charge (null for a run with no API quote).
results[].charge.charged_credits	number	yes	What the call has charged so far. Work that was never delivered is not counted. A test run is always 0.
results[].charge.final	boolean	yes	true once the run is over: the number can no longer change.
results[].price	object	no
results[].price.credits	number	yes	The most this call costs, in whole credits (1 credit = $0.01).
results[].price.usd	string	yes	The same price in US dollars, e.g. “0.0336”.
results[].price.tariff	“direct” | “outcome”	yes	“direct” = your prompt goes to the model as sent; “outcome” = a result we shape (Recast, creator video).
results[].price.tariff_version	string	yes
results[].price.expires_at	string	yes	The quoted price holds until then (ISO time).
results[].next	string	no	Present while the job is not finished.

Errors

Every error body is { error, code, request_id, ... }. All codes and what to do.

• 401: Missing, wrong, revoked or expired API key (code UNAUTHORIZED, KEY_REVOKED, KEY_EXPIRED).
• 403: The key may not do this (SCOPE_DENIED, MODEL_NOT_ALLOWED, TEST_MODE_UNSUPPORTED, ACCOUNT_BLOCKED, allowance_exceeded).
• 422: The request is not valid (VALIDATION_FAILED, INVALID_JSON, PREFLIGHT_FAILED, CALLBACK_URL_INVALID, REFERENCE_*). `issues` lists each problem. Nothing was charged.
• 429: Too many requests or jobs (RATE_LIMITED, CONCURRENCY_LIMIT, UPLOAD_QUOTA, …). Wait Retry-After seconds, then retry.
• 500: Our fault (INTERNAL_ERROR). Quote request_id to support.
• 503: Paused or busy (API_PAUSED, MODEL_PAUSED, PROVIDER_PAUSED, PROVIDER_BUSY, UNAVAILABLE). Wait Retry-After seconds, then retry.

Charges

Free. No credits are spent.