Get Worker Last Run

Method: GET

Endpoint: /api/v2/workers/{workerId}/runs/last

Authentication: Supports Authorization: Bearer <YOUR_API_KEY>, api-key: <YOUR_API_KEY>, and ?token=<YOUR_API_KEY>. Prefer Bearer token.

Try it

GET/api/v2/workers/{workerId}/runs/lastGet worker last run

AuthenticationRequired

Auth mode

Authorization: Bearerapi-key headerQuery token

API token

Stored only in this browser tab. Sent only to https://openapi.coreclaw.com.

Parameters

workerIdpath · stringRequired

Worker slug or path. You may paste `owner/name`; the playground sends it as `owner~name` for path values. The playground prefills an official Worker (`coreclaw/google-maps-scraper`); replace it with your own.

Request BodyNot applicable

No JSON request body. Fill the path or query parameters above.

Send Request Clear all

When to use this endpoint

Use this endpoint to read or operate on the latest run scoped to one Worker.

Identifier Notes

• workerId / worker_id accepts a Worker slug or a path encoded as owner~name from owner/name.

Path Parameters

Parameter	Required	Type	Description
workerId	Yes	string	Worker slug or path. You may paste owner/name; the playground sends it as owner~name for path values.

Request Example

curl -X GET "https://openapi.coreclaw.com/api/v2/workers/YOUR_WORKER_ID/runs/last" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response Example

{
  "code": 0,
  "data": {
    "duration": 10,
    "err_msg": "",
    "finished_at": 1782091210,
    "origin": "openapi",
    "results": 1,
    "scraper_slug": "demo-worker",
    "scraper_title": "Demo Worker",
    "slug": "01KKDXV2G26BT7NH4ZQR2R4NPZ",
    "started_at": 1782091200,
    "status": "running",
    "traffic": 0,
    "usage": "1.00",
    "version": "latest"
  },
  "message": "success",
  "request_id": "req-123"
}

Response Fields

data contains these run fields:

Field	Type	Description
slug	string	Run identifier; pass it as runId to detail, log, result, and export endpoints.
scraper_slug	string	Identifier of the Worker that ran.
scraper_title	string	Worker display name.
version	string	Worker version that actually ran, for example v1.2.8.
status	string	Run status and the primary outcome field. See Run Lifecycle & Status for values.
results	integer	Current or final number of result rows. 0 does not mean failure.
usage	string	Platform-recorded resource usage (numeric string) for observability and billing diagnostics.
traffic	integer	Platform-recorded traffic diagnostic value.
origin	string	Run origin, for example api_v2.
started_at	integer	Execution start time, Unix seconds.
finished_at	integer	Execution end time, Unix seconds.
duration	integer	Execution duration in seconds.
err_msg	string	Optional diagnostic text. It may be absent (successful runs usually omit it); use it only as supporting evidence, never as the sole success/failure signal.

Timestamps are Unix seconds (UTC). Cancellation, queueing, or state synchronization can produce incomplete or non-intuitive timing combinations; always treat status as authoritative.

Notes

• API v2 supports Bearer token, the legacy api-key header, and query token. Prefer Bearer token for new integrations.
• This is a Worker-scoped latest-run endpoint; workerId is required and the operation applies only to that Worker’s latest run.
• last means the latest run in the current scope. Use a concrete runId endpoint when the target must be explicit.
• See Run Lifecycle & Status for status handling, polling, failure diagnosis, and cancellation behavior.

HTTP Responses

HTTP Status	Application Code	Meaning
200	0	OK
400	11000	Bad Request
401	12001	Unauthorized
404	11004	Not Found
422	11000	Unprocessable Entity
429	13000	Too Many Requests
500	10000	Internal Server Error