---
title: "Queries jobs for the specified audience."
method: GET
path: "/audience/{audienceId}/jobs"
tags: ["Audience"]
---

# Queries jobs for the specified audience.

`GET /audience/{audienceId}/jobs`

## Request

- Base URL: `https://api.rapidata.ai`
- URL: `https://api.rapidata.ai/audience/{audienceId}/jobs`
- Auth: OpenID Connect (`https://auth.rapidata.ai/.well-known/openid-configuration`, scopes: `openid`, `profile`, `email`, `offline_access`, `api`)

## Path parameters

- `audienceId` string, required

## Query parameters

- `page` integer
- `page_size` integer
- `sort` string[]
- `job_id` object
  - `eq` string
  - `neq` string
  - `gt` string
  - `gte` string
  - `lt` string
  - `lte` string
  - `contains` string
  - `starts_with` string
  - `ends_with` string
  - `in` string[]
  - `not_contains` string
- `name` object
  - `eq` string
  - `neq` string
  - `gt` string
  - `gte` string
  - `lt` string
  - `lte` string
  - `contains` string
  - `starts_with` string
  - `ends_with` string
  - `in` string[]
  - `not_contains` string
- `definition_id` object
  - `eq` string
  - `neq` string
  - `gt` string
  - `gte` string
  - `lt` string
  - `lte` string
  - `contains` string
  - `starts_with` string
  - `ends_with` string
  - `in` string[]
  - `not_contains` string
- `status` object
  - `eq` string
  - `neq` string
  - `gt` string
  - `gte` string
  - `lt` string
  - `lte` string
  - `contains` string
  - `starts_with` string
  - `ends_with` string
  - `in` string[]
  - `not_contains` string
- `created_at` object
  - `eq` string
  - `neq` string
  - `gt` string
  - `gte` string
  - `lt` string
  - `lte` string
  - `contains` string
  - `starts_with` string
  - `ends_with` string
  - `in` string[]
  - `not_contains` string
- `logic` 'and' | 'or'

## Response `200`

OK

- QueryAudienceJobsEndpointPagedResultOfOutput
  - `total` integer, required
  - `page` integer, required
  - `pageSize` integer, required
  - `items` QueryAudienceJobsEndpointOutput[], required
    - `jobId` string, required: The unique identifier of the job.
    - `name` string, required: The name of the job.
    - `definitionId` string, required: The identifier of the job definition.
    - `audienceId` string, required: The identifier of the audience the job belongs to.
    - `revisionNumber` integer, required: The revision number of the job definition.
    - `pipelineId` string, required: The identifier of the pipeline executing the job.
    - `state` 'Submitted' | 'Running' | 'Completed' | 'Failed' | 'ManualApproval' | 'Queued' | 'Paused' | 'StaleResults' | 'SpendLimited' | 'Blocked', required
    - `createdAt` string, date-time, required: The timestamp when the job was created.
  - `totalPages` integer

## Other responses

- `400`: Bad Request
- `401`: Unauthenticated
- `403`: Forbidden

## Changes

- **2026-10-13** `bf98b6cb9b5a`: 1 warning
  - added the new `Blocked` enum value to the `items/items/state/allOf[#/components/schemas/AudienceJobState]/` response property for the response status `200`
- **2026-09-04** `9da534659e5f`: 1 info
  - the security scope `api` was added to the endpoint's security scheme `OpenIdConnect`

[Operation history](https://skmtc.dev/rapidata/apis/rapidata-api/changes/audience/:audienceId/jobs/get.md)

---

[API](https://skmtc.dev/rapidata/apis/rapidata-api.md) - [All operations](https://skmtc.dev/rapidata/apis/rapidata-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rapidata/apis/rapidata-api/revisions/004a977d7d9f?raw)