---
title: "Jobs.QueryPage"
description: "Query a single page of jobs matching the provided options."
image: "https://tilebox.com/images/tilebox-docs-social-preview.png"
---

> Documentation Index
> Fetch the complete documentation index at: https://tilebox.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Jobs.QueryPage

import { Fragment } from "astro/jsx-runtime";

import ApiReference from "@docs/components/ApiReference.astro";

import ParamField from "@docs/components/ParamField.astro";

```go
func (jobClient) QueryPage(
    ctx context.Context,
    options ...job.QueryOption,
) (*workflows.JobPage, error)
```

Query a single page of jobs matching the provided options.

Use `QueryPage` when you need manual pagination. Use [`Jobs.Query`](/docs/api-reference/go/workflows/Jobs.Query) for automatic lazy pagination.

## Parameters

**options**

type: []job.QueryOption

Options for querying jobs.

## Options

**job.WithTemporalExtent(temporalExtent query.TemporalExtent)**

Filter jobs by time or job ID interval.
**job.WithAutomationIDs(automationIDs ...uuid.UUID)**

Filter jobs by the automations that submitted them.
**job.WithJobStates(states ...job.State)**

Filter jobs by job state.
**job.WithTaskStates(states ...job.TaskState)**

Filter jobs by task state. Only jobs with at least one task in any of the given states are returned.
**job.WithJobName(name string)**

Filter jobs by name.
**job.WithCursor(cursor *job.Cursor)**

Start the query after the cursor returned by a previous page.
**job.WithLimit(limit int64)**

Limit the number of jobs returned in this page.
**job.WithSortDirection(direction job.SortDirection)**

Sort jobs by submission date. Use `job.Ascending` for oldest first or `job.Descending` for newest first.

## Returns

A `JobPage` with jobs and an optional `NextCursor` for the next page.

<h2 id="request-example">Usage example</h2>

```go
page, err := client.Jobs.QueryPage(ctx,
    job.WithJobStates(job.Running, job.Started),
    job.WithLimit(50),
    job.WithSortDirection(job.Descending),
)
if err != nil {
    return err
}

if page.NextCursor != nil {
    nextPage, err := client.Jobs.QueryPage(ctx,
        job.WithCursor(page.NextCursor),
        job.WithLimit(50),
    )
    _ = nextPage
    _ = err
}
```

Source: https://tilebox.com/docs/api-reference/go/workflows/Jobs.QueryPage/index.mdx