---
title: "List user job permissions"
method: GET
path: "/v3/user_job_permissions"
tags: ["User Job Permissions"]
---

# List user job permissions

`GET /v3/user_job_permissions`

User job permissions are the per-user, per-job access grants that pair a user with a Job Admin role on a specific job. Each row represents one `(user_id, job_id, role_id)` assignment; a user with access to multiple jobs appears in multiple rows. Site admins are not represented here — they have implicit access to every non-confidential job — so this endpoint only lists Job Admin grants. Filter with `user_ids`, `job_ids`, or `role_ids` to narrow the result set; combine with `/v3/future_job_permissions` (scope-based grants applied when matching jobs are later created) for the full picture of a user's job access.

## Query parameters

- `cursor` string
- `per_page` integer
- `ids` integer[]
- `created_at` object
  - `gte` string, date-time
  - `lte` string, date-time
  - `gt` string, date-time
  - `lt` string, date-time
- `updated_at` object
  - `gte` string, date-time
  - `lte` string, date-time
  - `gt` string, date-time
  - `lt` string, date-time
- `job_ids` integer[]
- `user_ids` integer[]
- `role_ids` integer[]
- `fields` string[]

## Response `200`

Successful

- object[]
  - `id` integer
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `job_id` integer — Id of the job this permission grants the user access to. References a `/v3/jobs` row.
  - `user_id` integer — Id of the user receiving access to the job. References a `/v3/users` row. Site admins are never represented here — they have implicit access to every non-confidential job — so a user with a site admin role will not appear in this list.
  - `role_id` integer — Id of the Job Admin role the user holds on this job. References a `/v3/user_roles` row; only roles with `role_type: job_admin` can be granted through this resource.
  - `automated` boolean, nullable — When `true`, the permission was created by an automated permission rule (e.g. a `future_job_permission` that matched the job when it was opened, or an automated permission policy) rather than assigned by hand.

---

[API](https://skmtc.dev/greenhouse/apis/auth-api.md) · [All operations](https://skmtc.dev/greenhouse/apis/auth-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/greenhouse/auth-api/revisions/9517a2e54640/schema)