Skip to main content
GET
Get the status of an agent job
Are you an AI agent that needs a Firecrawl API key? See firecrawl.dev/agent-onboarding/SKILL.md for automated onboarding instructions.

Authorizations

Authorization
string
header
required

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

Path Parameters

jobId
string<uuid>
required

The ID of the agent job

Response

Successful response

success
boolean
status
enum<string>
Available options:
processing,
completed,
failed
data
object

The extracted data (only present when status is completed)

model
enum<string>
default:spark-2

Model preset used for the agent run. Every new run executes on spark-2; Spark 1 names only appear on legacy runs.

Available options:
spark-2,
spark-1-pro,
spark-1-mini
effort
enum<string>

Reasoning budget used for the agent run (only present for runs that set effort)

Available options:
low,
medium,
high
error
string

Error message (only present when status is failed)

expiresAt
string<date-time>
creditsUsed
number