List Agent Runs

1 min read

get/agent

Request example

curl --request GET \
  --url https://api.firecrawl.dev/v2/agent \
  --header 'Authorization: Bearer <token>'

Response

{
  "success": true,
  "agents": [
    {
      "id": "<string>",
      "createdAt": "2026-08-10T12:00:00Z",
      "targetHint": "<string>",
      "origin": "<string>",
      "integration": "<string>",
      "settings": {
        "hidden": true,
        "starred": true,
        "label": "<string>"
      },
      "status": "processing",
      "options": {
        "urls": [
          "<string>"
        ],
        "prompt": "<string>",
        "schema": {},
        "model": "spark-2",
        "effort": "low"
      }
    }
  ],
  "next": "<string>"
}

get/agent

Are you an AI agent that needs a Firecrawl API key? See firecrawl.dev/agent-onboarding/SKILL.md for automated onboarding instructions.

Authorization

Authorizationstringheaderrequired#

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

Query parameters

beforeinteger#

Only return agent runs created before this unix millisecond timestamp. Pages are fixed at 20 runs; use the before value from the previous page's next URL to fetch the next page.

Range: >= 0

Responses

application/json

List of agent runs, most recent first

successboolean#

agentsobject[]#

Show child attributes

idstring#

createdAtstring#

targetHintstring#

Short hint describing the run's target (first URL or prompt)

originstring#

Origin of the run (e.g. "api")

integrationstring#

Integration identifier, if the run was started with one

settingsobject#

Show child attributes

hiddenboolean#

starredboolean#

labelstring#

statusenum<string>#

Options:processingcompletedfailed

optionsobject#

Options the run was started with

Show child attributes

urlsstring[]#

promptstring#

schemaobject#

modelenum<string>#

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

Options:spark-2spark-1-prospark-1-mini

effortenum<string>#

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

Options:lowmediumhigh

nextstring#

Absolute URL of the next page. Only present when more pages exist.

Agent Get Agent Status