Firecrawl Agent Status
Check the progress or retrieve the completed result of an existing Firecrawl agent job. Input: `id` (required string), the job ID returned by `firecrawl_agent`. It is the only accepted parameter; the schema does not impose a UUID format. Returns: a JSON object that may contain `id`, `success`, `status`, `progress`, `data` when completed, and `error` when unsuccessful. `success` describes the API call, not whether the research has finished. `processing` means the job is still running; `completed` and `failed` are terminal states. Failed jobs may return an incomplete best-effort `partial` result and `partialSchemaValid`; partial output must not be presented as a completed answer. Optional metadata includes `sources`, `message`, `mode`, `model`, `threadId`, `threadTurn`, `conversationId`, `suggestions`, `creditsUsed`, `expiresAt`, `stopReason`, `notice`, `exchange`, `pendingApproval`, and `agent_hints`. Availability varies, and some values may be null. `credit_limit_reached` indicates that a failed run reached its credit limit. Results are no longer readable after their expiration. Asynchronous behavior: the underlying research runs asynchronously, but each invocation of this tool performs one status/result lookup. It does not submit a job, wait until completion, or automatically poll. While the status is `processing`, check again after 15–30 seconds if time permits. Typical runs take roughly 1–3 minutes; complex research can take 5 minutes or more. These durations are estimates, not guarantees, and elapsed time alone does not establish failure. Stop completion polling on `completed` or `failed`. Limitations: read-only lookup for an existing job. It cannot start, modify, cancel, or resume research, accept provider terms, or approve paid calls. Approval-related fields only report information; no approval input is supported here. No prompt, polling-interval, or timeout parameter is exposed.
Pricing
| Condition | Charge |
|---|---|
| Each call | 0 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
id | string | Yes | No parameter description. | — |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_firecrawl_agent_status' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"id": "01a19cd5-868c-71c8-9c9a-10b3d5f517f5"
}
}'{
"conversationId": "4f0dbfff-4b42-40e9-989e-fce581578e9d",
"data": {
"benchmarks": [
{
"name": "BrowseComp",
"publisher": "OpenAI",
"release_month": "2025-04",
"sample_size": 1266,
"url": "https://arxiv.org/abs/2504.12516"
}
]
},
"message": "Collected three public 2025 agent benchmarks with official paper URLs and task/example counts.",
"status": "completed",
"success": true
}This example shows part of the response. Copied content is valid JSON.

