# RequestQueueHead<!-- -->

Model for request queue head.

Represents a collection of requests retrieved from the beginning of a queue, including metadata about the queue's state and lock information for the requests.

## Index[](#Index)

### Methods

* [from_client_locked_head](https://docs.apify.com/sdk/python/reference/class/RequestQueueHead.md#from_client_locked_head)

### Properties

* [had_multiple_clients](https://docs.apify.com/sdk/python/reference/class/RequestQueueHead.md#had_multiple_clients)
* [items](https://docs.apify.com/sdk/python/reference/class/RequestQueueHead.md#items)
* [limit](https://docs.apify.com/sdk/python/reference/class/RequestQueueHead.md#limit)
* [lock_time](https://docs.apify.com/sdk/python/reference/class/RequestQueueHead.md#lock_time)
* [model_config](https://docs.apify.com/sdk/python/reference/class/RequestQueueHead.md#model_config)
* [queue_has_locked_requests](https://docs.apify.com/sdk/python/reference/class/RequestQueueHead.md#queue_has_locked_requests)
* [queue_modified_at](https://docs.apify.com/sdk/python/reference/class/RequestQueueHead.md#queue_modified_at)

## Methods<!-- -->[](#Methods)

### [](#from_client_locked_head)[](https://github.com/apify/apify-sdk-python/blob/9d3eab5077ba7529077bc1c9ebe16658169a8eca//src/apify/storage_clients/_apify/_models.py#L68)from_client_locked_head

* **from_client_locked_head**(client_locked_head): [RequestQueueHead](https://docs.apify.com/sdk/python/reference/class/RequestQueueHead.md)

- Create a `RequestQueueHead` from an Apify API client's `LockedRequestQueueHead` model.

  ***

  #### Parameters

  * ##### client_locked_head: LockedRequestQueueHead

    `LockedRequestQueueHead` instance from Apify API client.

  #### Returns [RequestQueueHead](https://docs.apify.com/sdk/python/reference/class/RequestQueueHead.md)

  `RequestQueueHead` instance with properly converted types.

## Properties<!-- -->[](#Properties)

### [](#had_multiple_clients)[](https://github.com/apify/apify-sdk-python/blob/9d3eab5077ba7529077bc1c9ebe16658169a8eca//src/apify/storage_clients/_apify/_models.py#L45)had_multiple_clients

had_multiple_clients: bool

Indicates whether the queue has been accessed by multiple clients (consumers).

### [](#items)[](https://github.com/apify/apify-sdk-python/blob/9d3eab5077ba7529077bc1c9ebe16658169a8eca//src/apify/storage_clients/_apify/_models.py#L64)items

items: list\[Request]

The list of request objects retrieved from the beginning of the queue.

### [](#limit)[](https://github.com/apify/apify-sdk-python/blob/9d3eab5077ba7529077bc1c9ebe16658169a8eca//src/apify/storage_clients/_apify/_models.py#L42)limit

limit: int | None

The maximum number of requests that were requested from the queue.

### [](#lock_time)[](https://github.com/apify/apify-sdk-python/blob/9d3eab5077ba7529077bc1c9ebe16658169a8eca//src/apify/storage_clients/_apify/_models.py#L51)lock_time

lock_time: timedelta | None

The duration for which the returned requests are locked and cannot be processed by other clients.

The platform's API names this field `lockSecs`, so it is serialized under that alias instead of the `lockTime` that `to_camel` would derive from the field name.

### [](#model_config)[](https://github.com/apify/apify-sdk-python/blob/9d3eab5077ba7529077bc1c9ebe16658169a8eca//src/apify/storage_clients/_apify/_models.py#L40)model_config

model_config: Undefined

### [](#queue_has_locked_requests)[](https://github.com/apify/apify-sdk-python/blob/9d3eab5077ba7529077bc1c9ebe16658169a8eca//src/apify/storage_clients/_apify/_models.py#L61)queue_has_locked_requests

queue_has_locked_requests: bool | None

Indicates whether the queue contains any locked requests.

### [](#queue_modified_at)[](https://github.com/apify/apify-sdk-python/blob/9d3eab5077ba7529077bc1c9ebe16658169a8eca//src/apify/storage_clients/_apify/_models.py#L48)queue_modified_at

queue_modified_at: datetime

The timestamp when the queue was last modified.
