Get extract job status

Get the status of an extract job

Endpoint

GET /v1/extract/{id}

Authentication

This endpoint requires authentication using a Bearer token. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Path Parameters

id · string · required

The ID of the extract job

Response

success · boolean

Indicates whether the request was successful

status · string

The current status of the extract job. Can be completed, processing, failed, or cancelled.

data · object

The extracted data according to your schema. Only present when status is completed.

expiresAt · string

The date and time when the extract job data will expire (ISO 8601 format)

Examples

cURL

curl -X GET https://api.firecrawl.dev/v1/extract/123e4567-e89b-12d3-a456-426614174000 \
  -H 'Authorization: Bearer YOUR_API_KEY'

Response Example

{
  "success": true,
  "status": "completed",
  "data": {
    "title": "Example Article Title",
    "author": "John Doe"
  },
  "expiresAt": "2026-03-10T12:00:00Z"
}