---
title: "GET /api/field-permissions/{field_id}/subjects/"
method: GET
path: "/api/field-permissions/{field_id}/subjects/"
tags: ["Field permissions"]
---

# GET /api/field-permissions/{field_id}/subjects/

`GET /api/field-permissions/{field_id}/subjects/`

Searches users and teams that can be selected for a field-specific permission. Results are paginated and exclude the requested subjects.

This is an **enterprise** feature.

## Path parameters

- `field_id` string, required

## Query parameters

- `exclude_team_ids` integer[]
- `exclude_user_ids` integer[]
- `page` integer
- `search` string, nullable
- `size` integer

## Response `200`

- PaginationSerializerFieldPermissionSubjectOptionResponse
  - `count` integer, required — The total amount of results.
  - `next` string, uri, nullable, required — URL to the next page.
  - `previous` string, uri, nullable, required — URL to the previous page.
  - `results` FieldPermissionSubjectOptionResponse[], required
    - `subject_id` integer, required
    - `subject_type` 'auth.User' | 'baserow_enterprise.Team', required — * `auth.User` - auth.User * `baserow_enterprise.Team` - baserow_enterprise.Team
    - `name` string, required
    - `email` string, email, nullable, required
    - `subject_count` integer, nullable, required

## Other responses

- `400`
- `404`

## Changes

- **2026-08-27** `f3396317d932` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/baserow/apis/baserow-api-spec/changes/api/field-permissions/:field_id/subjects/get.md)

---

[API](https://skmtc.dev/baserow/apis/baserow-api-spec.md) · [All operations](https://skmtc.dev/baserow/apis/baserow-api-spec/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/baserow/baserow-api-spec/revisions/85eb57bdcf1b/schema)