---
title: "List Access Grants"
method: GET
path: "/api/v1/admin/block/dataset-restrictions"
tags: ["Admin APIs", "block-dataset-restrictions"]
---

# List Access Grants

`GET /api/v1/admin/block/dataset-restrictions`

List access-grant rows. Mode selected by query params:

- ``client_id`` only ⇒ all rows for the client across every dataset
  (client-side "Block Restrictions" section, read-only).
- ``client_id`` + ``dataset_id`` ⇒ all cuts' rows for that
  client+dataset (shared editor).
- ``dataset_id`` + ``scope=dataset`` ⇒ all rows for the dataset across
  every cut, with client info (dataset-side "Manage access" list).
- ``dataset_id`` + ``cut`` ⇒ rows for that exact (dataset, cut), with
  client info.

``cut`` is ignored when ``scope=dataset`` or ``client_id`` is set.

## Query parameters

- `dataset_id` string, nullable
- `cut` string, nullable
- `client_id` string, uuid, nullable
- `scope` string, nullable

## Response `200`

Successful Response

- BlockClientDataAccessListResponse
  - `items` BlockClientDataAccessRead[], required
    - `id` string, uuid, required
    - `client_id` string, uuid, required
    - `client_name` string, nullable
    - `client_external_id` string, nullable
    - `dataset_id` string, required
    - `cut` string, nullable
    - `access` boolean
    - `sample_access` boolean
    - `served_lag` string, nullable
    - `served_lag_is_stale` boolean
    - `row_version` integer, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `created_by` string, nullable
    - `updated_by` string, nullable
    - `previous_rationale` string, nullable
  - `total` integer, required
  - `block_sample_access_follows_live` boolean, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api.md) · [All operations](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbonarc/carbon-arc-client-admin-api/revisions/a8ca30023371/schema)