Skip to main content
GET
Poll an asynchronous Oxylabs LLM job.
Fetch an Oxylabs LLM job submitted by post_oxylabs_llm, by its jobId. Returns the same envelope — id, status, createdAt, completedAt, pricing, output, error. Repeat until status is completed, failed, or cancelled; on success output carries results[] with the parsed answer text and cited sources. Reads a job only; it cannot start one.
First time? Point any MCP client at https://mcp.aisa.one/mcp — Claude Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client opens a browser, you click Allow once, and there is no key to paste. The commands per client, and what each call costs, are on aisa.one/mcp.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

jobId
string
required

The job id returned by the submit call.

Response

200 - application/json

The current state of the LLM job.

An asynchronous Oxylabs LLM job. Returned by the submit call (HTTP 202) and by the poll call. Poll the job by its id until status is terminal (completed, failed, or cancelled).

id
string

Unique AIsa job identifier. Use it to poll or cancel the job.

Example:

"async_job_351d6f429fb6fbe8f505f7d12bfe56b30739a210"

object
string

Always "integration_async_job".

Example:

"integration_async_job"

endpoint
string

The submit endpoint this job belongs to.

Example:

"/apis/v1/oxylabs/llm"

status
enum<string>

Customer-facing lifecycle status. queued and running are non-terminal; completed, failed, and cancelled are terminal.

Available options:
queued,
running,
completed,
failed,
cancelled
createdAt
string<date-time>

When the job was accepted.

completedAt
string<date-time> | null

When the job reached a terminal status. Null while queued or running.

pricing
object
output
object | null

Job result payload. Present only once status is completed. Carries results[]; the parsed shape inside each entry's content varies by source — chatgpt/gemini return response_text plus citations[], and perplexity returns answer_results / answer_results_md (the answer text) with cited sources under additional_results.sources_results[].

error
object | null

Present when status is failed. Null otherwise.