List requests in queue for last run

GET 
/v2/acts/:actorId/runs/last/request-queue/requests

Returns requests from the default request queue of the last Actor run. Redispatches to List requests.

Using the status query parameter you can ensure to only get a run with a certain status (e.g. status=SUCCEEDED). Only the most recent run with that status is used.

Request

Path Parameters

actorId string required
Actor ID or a tilde-separated owner's username and Actor name.

Example: janedoe~my-actor

Query Parameters

status string
Filter for the run status. Only the most recent run with this status is used.

Example: SUCCEEDED
exclusiveStartId string

All requests up to this one (including) are skipped from the result.

limit number
Maximum number of requests to return.

Example: 100

Status 200

Response Headers

{
  "data": {
    "items": [
      {
        "id": "dnjkDMKLmdlkmlkmld",
        "uniqueKey": "GET|60d83e70|e3b0c442|https://apify.com/career",
        "url": "https://apify.com/career",
        "method": "GET",
        "retryCount": 0,
        "loadedUrl": "https://apify.com/jobs",
        "payload": "Unknown Type: object,null",
        "headers": "Unknown Type: object,null",
        "userData": {
          "label": "DETAIL",
          "image": "https://picserver1.eu"
        },
        "noRetry": false,
        "errorMessages": "Unknown Type: array,null",
        "handledAt": "2019-06-16T10:23:31.607Z"
      }
    ],
    "count": 2,
    "limit": 2,
    "exclusiveStartId": "Ihnsp8YrvJ8102Kj"
  }
}

Schema

• data object required

  A paginated list of requests from the request queue.

  • items object[] required

    The array of requests.

    • id string required

      A unique identifier assigned to the request.

      
      Example: dnjkDMKLmdlkmlkmld
    • uniqueKey string required

      A unique key used for request de-duplication. Requests with the same unique key are considered identical.

      
      Example: GET|60d83e70|e3b0c442|https://apify.com/career
    • url string<uri> required

      The URL of the request.

      
      Example: https://apify.com/career
    • method string

      The HTTP method of the request.

      
      Example: GET
    • retryCount integer

      The number of times this request has been retried.

      
      Example: 0
    • loadedUrl string,null<uri> nullable

      The final URL that was loaded, after redirects (if any).

      
      Example: https://apify.com/jobs
    • payload object | null nullable

      The request payload, typically used with POST or PUT requests.

    • headers object | null nullable

      HTTP headers sent with the request.

    • userData object

      Custom user data attached to the request. Can contain arbitrary fields.

      • label string | null nullable

        Optional label for categorizing the request.

        
        Example: DETAIL
      • image string,null<uri> nullable

        Optional image URL associated with the request.

        
        Example: https://picserver1.eu
      • property name* any

        Custom user data attached to the request. Can contain arbitrary fields.

    • noRetry boolean | null nullable

      Indicates whether the request should not be retried if processing fails.

      
      Example: false
    • errorMessages string[] nullable

      Error messages recorded from failed processing attempts.

    • handledAt string,null<date-time> nullable

      The timestamp when the request was marked as handled, if applicable.

      
      Example: 2019-06-16T10:23:31.607Z
  • count integer

    The total number of requests matching the query.

    
    Example: 2
  • limit integer required

    The maximum number of requests returned in this response.

    
    Example: 2
  • exclusiveStartId string

    The ID of the last request from the previous page, used for pagination.

    
    Example: Ihnsp8YrvJ8102Kj

Status 400

Bad request - invalid input parameters or request body.

{
  "error": {
    "type": "invalid-input",
    "message": "Invalid input: The request body contains invalid data."
  }
}

Schema

• error object required

  • type string required
    Example: run-failed
  • message string required
    Example: Actor run did not succeed (run ID: 55uatRrZib4xbZs, status: FAILED)