Last Actor run's default request queue

Get the default request queue head for an Actor's last run

Changed on Oct 27, 2026

Returns the given number of first requests from the default request queue of the last Actor run.

This endpoint is a shortcut for getting the last run's defaultRequestQueueId and then using the Get request queue head endpoint.

get/v2/actors/{actorId}/runs/last/request-queue/head

Request

Base URL
https://api.apify.com
Auth
- HTTP bearer
- or API key in query parameter token

Path parameters

actorIdstring required

Example:compass~google-maps-extractor

Actor ID or the username of the Actor owner and the Actor name, separated by a tilde (~).

Query parameters

statusstring

Example:SUCCEEDED

Filter for the run status.

origin'DEVELOPMENT' | 'WEB' | 'API' | 'SCHEDULER' | 'TEST' | 'WEBHOOK' | 'ACTOR' | 'CLI' | 'CI' | 'STANDBY' | 'MCP'

Filter for the run origin, i.e. the means by which the run was started.

limitnumber double

Example:100

How many items from queue should be returned.

clientKeystring

Example:client-abc

A unique identifier of the client accessing the request queue. It must be a string between 1 and 32 characters long. This identifier is used to determine whether the queue was accessed by multiple clients. If clientKey is not provided, the system considers this API call to come from a new client. For details, see the hadMultipleClients field returned by the Get request queue head endpoint.

Response

Example response

{
  "data": {
    "limit": 1000,
    "queueModifiedAt": "2018-03-14T23:00:00.000Z",
    "hadMultipleClients": false,
    "items": [
      {
        "id": "8OamqXBCpPHxyH9",
        "retryCount": 0,
        "uniqueKey": "http://example.com",
        "url": "http://example.com",
        "method": "GET"
      },
      {
        "id": "ZJAoqlRijenMQIn",
        "retryCount": 0,
        "uniqueKey": "http://example.com/a/b",
        "url": "http://example.com/a/b",
        "method": "GET"
      },
      {
        "id": "hAhkwyk5oOBHKQC",
        "retryCount": 1,
        "uniqueKey": "http://example.com/c/d",
        "url": "http://example.com/c/d",
        "method": "GET"
      }
    ]
  }
}

Changes

Oct 27, 2026ec76185eb934 Revision changes
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
Oct 20, 202616b486b0397a Revision changes
- warning
  added the new full-permissions-require-verified-owner enum value to the / response property for the response status
- warning
  added the new full-permissions-require-verified-owner enum value to the / response property for the response status
- warning
  added the new full-permissions-require-verified-owner enum value to the / response property for the response status
- warning
  added the new full-permissions-require-verified-owner enum value to the / response property for the response status
- warning
  added the new full-permissions-require-verified-owner enum value to the / response property for the response status
- warning
  added the new full-permissions-require-verified-owner enum value to the / response property for the response status
- warning
  added the new full-permissions-require-verified-owner enum value to the / response property for the response status
- warning
  added the new input-validation-timed-out enum value to the / response property for the response status
- warning
  added the new input-validation-timed-out enum value to the / response property for the response status
- warning
  added the new input-validation-timed-out enum value to the / response property for the response status
- warning
  added the new input-validation-timed-out enum value to the / response property for the response status
- warning
  added the new input-validation-timed-out enum value to the / response property for the response status
- warning
  added the new input-validation-timed-out enum value to the / response property for the response status
- warning
  added the new input-validation-timed-out enum value to the / response property for the response status
- warning
  added the new mcp-connector-actor-not-allowed enum value to the / response property for the response status
- warning
  added the new mcp-connector-actor-not-allowed enum value to the / response property for the response status
- warning
  added the new mcp-connector-actor-not-allowed enum value to the / response property for the response status
- warning
  added the new mcp-connector-actor-not-allowed enum value to the / response property for the response status
- warning
  added the new mcp-connector-actor-not-allowed enum value to the / response property for the response status
- warning
  added the new mcp-connector-actor-not-allowed enum value to the / response property for the response status
- warning
  added the new mcp-connector-actor-not-allowed enum value to the / response property for the response status
- warning
  added the new more-public-actors-require-verified-owner enum value to the / response property for the response status
- warning
  added the new more-public-actors-require-verified-owner enum value to the / response property for the response status
- warning
  added the new more-public-actors-require-verified-owner enum value to the / response property for the response status
- warning
  added the new more-public-actors-require-verified-owner enum value to the / response property for the response status
- warning
  added the new more-public-actors-require-verified-owner enum value to the / response property for the response status
- warning
  added the new more-public-actors-require-verified-owner enum value to the / response property for the response status
- warning
  added the new more-public-actors-require-verified-owner enum value to the / response property for the response status
- warning
  added the new readme-required enum value to the / response property for the response status
- warning
  added the new readme-required enum value to the / response property for the response status
- warning
  added the new readme-required enum value to the / response property for the response status
- warning
  added the new readme-required enum value to the / response property for the response status
- warning
  added the new readme-required enum value to the / response property for the response status
- warning
  added the new readme-required enum value to the / response property for the response status
- warning
  added the new readme-required enum value to the / response property for the response status
- warning
  added the new schemas-required enum value to the / response property for the response status
- warning
  added the new schemas-required enum value to the / response property for the response status
- warning
  added the new schemas-required enum value to the / response property for the response status
- warning
  added the new schemas-required enum value to the / response property for the response status
- warning
  added the new schemas-required enum value to the / response property for the response status
- warning
  added the new schemas-required enum value to the / response property for the response status
- warning
  added the new schemas-required enum value to the / response property for the response status
- warning
  added the new standby-deployment-invalid enum value to the / response property for the response status
- warning
  added the new standby-deployment-invalid enum value to the / response property for the response status
- warning
  added the new standby-deployment-invalid enum value to the / response property for the response status
- warning
  added the new standby-deployment-invalid enum value to the / response property for the response status
- warning
  added the new standby-deployment-invalid enum value to the / response property for the response status
- warning
  added the new standby-deployment-invalid enum value to the / response property for the response status
- warning
  added the new standby-deployment-invalid enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-account enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-account enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-account enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-account enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-account enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-account enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-account enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-actor enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-actor enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-actor enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-actor enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-actor enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-actor enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-actor enum value to the / response property for the response status

Operation history (6 revisions)