---
title: "POST /queue/search - Queue · RUAL Documentation"
description: "POST: Search queue jobs using request body with complex queries"
canonical: https://docs.rual.nl/cluster/api/queue/queue-search-post
language: en
---

# POST /queue/search

Search queue jobs using request body with complex queries

| Key | Type | Example | Description |
| --- | --- | --- | --- |
| **[authorization](https://docs.rual.nl/cluster/api#token-providing)** required | `string` | `"Bearer access_token"` | Access token |

| Key | Type | Example | Description |
| --- | --- | --- | --- |
| **from** optional | `integer` | `0` | Starting position for pagination |
| **must** optional | `array` | [{}] | Conditions that must match |
| **range** optional | `object` | {} | Range queries for dates/numbers |
| **should** optional | `array` | [{}] | Conditions that should match |
| **size** optional | `integer` | `10` | Number of results to return |
| **term** optional | `object` | {} | Term-based search criteria |

```
{}
```

```
{
  "error": "ERROR_KEY"
}
```

| Permission | Description |
| --- | --- |
| `Bearer token` | Access token required via Authorization header, x-authtoken, x-token, query param, or cookie |
| `queue_view` | Required scope: queue_view |