---
title: "List access requests"
method: GET
path: "/api/datasets/{namespace}/{repo}/user-access-request/{status}"
tags: ["datasets"]
---

# List access requests

`GET /api/datasets/{namespace}/{repo}/user-access-request/{status}`

List access requests for a gated repository

## Path parameters

- `namespace` string, required
- `repo` string, required
- `status` 'pending' | 'accepted' | 'rejected', required

## Query parameters

- `limit` integer
- `after` string, date-time
- `before` string, date-time
- `q` string — Search requests by requester username, fullname, email, email domain or verified organization

## Response `200`

List of access requests for the gated repository

- object[]
  - `user` object
    - `_id` string, required — A hex string of 24 characters representing an ObjectId.
    - `orgs` object[]
      - `id` string, required
      - `name` string, required
      - `fullname` string, required
      - `avatarUrl` string, required
    - `avatarUrl` string, required
    - `fullname` string, required
    - `isPro` boolean, required
    - `user` string, required
    - `numModels` number
    - `numDatasets` number
    - `numSpaces` number
    - `numBuckets` number
    - `numKernels` number
    - `numDiscussions` number
    - `numPapers` number
    - `numUpvotes` number
    - `numLikes` number
    - `numFollowers` number
    - `numFollowing` number
    - `numFollowingOrgs` number
    - `details` string
    - `isFollowing` boolean
    - `reasonToFollow` string
    - `primaryOrgAvatarUrl` string
    - `serviceAccount` object — Set when the user is a service account
      - `id` string, required — A hex string of 24 characters representing an ObjectId.
      - `org` string, required
      - `orgAvatarUrl` string, required
      - `description` string
    - `type` 'user', required
    - `email` string
    - `verifiedOrgNames` string[], required
  - `grantedBy` union
    - object
      - `_id` string, required — A hex string of 24 characters representing an ObjectId.
      - `orgs` object[]
        - `id` string, required
        - `name` string, required
        - `fullname` string, required
        - `avatarUrl` string, required
      - `avatarUrl` string, required
      - `fullname` string, required
      - `isPro` boolean, required
      - `user` string, required
      - `numModels` number
      - `numDatasets` number
      - `numSpaces` number
      - `numBuckets` number
      - `numKernels` number
      - `numDiscussions` number
      - `numPapers` number
      - `numUpvotes` number
      - `numLikes` number
      - `numFollowers` number
      - `numFollowing` number
      - `numFollowingOrgs` number
      - `details` string
      - `isFollowing` boolean
      - `reasonToFollow` string
      - `primaryOrgAvatarUrl` string
      - `serviceAccount` object — Set when the user is a service account
        - `id` string, required — A hex string of 24 characters representing an ObjectId.
        - `org` string, required
        - `orgAvatarUrl` string, required
        - `description` string
      - `type` 'user', required
      - `email` string
    - object
  - `status` 'accepted' | 'rejected' | 'pending', required
  - `fields` object
  - `timestamp` string, date-time, required
  - `reviewedAt` string, date-time

## Changes

- **2026-09-08** `bd17546f47b8` — 3 breaking, 2 warning, 2 info
  - the `items/grantedBy/anyOf[subschema #1]/type` response's property type changed from no type to `string` for status `200`
  - the `items/status` response's property type changed from no type to `string` for status `200`
  - the `items/user/type` response's property type changed from no type to `string` for status `200`
  - changed the pattern of the `query` request parameter `after` from `^((\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-((0[13578]|1[02])-(0[1-9]|[12]\d|3[01])|(0[469]|11)-(0[1-9]|[12]\d|30)|(02)-(0[1-9]|1\d|2[0-8])))T([01]\d|2[0-3]):[0-5]\d:[0-5]\d(\.\d+)?(Z)$` to `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$`
  - …3 more
- **2026-08-21** `4ea565dddd8a` — 2 info
  - added the optional property `items/grantedBy/anyOf[subschema #1]/serviceAccount` to the response with the `200` status
  - added the optional property `items/user/serviceAccount` to the response with the `200` status
- **2026-08-19** `ace7d1baa8f3` — 1 info
  - added the new optional `query` request parameter `q`
- …earlier changes not shown

[Full history](https://skmtc.dev/huggingface/apis/hub-api-endpoints/changes/api/datasets/:namespace/:repo/user-access-request/:status/get.md)

---

[API](https://skmtc.dev/huggingface/apis/hub-api-endpoints.md) · [All operations](https://skmtc.dev/huggingface/apis/hub-api-endpoints/llms.txt) · [OpenAPI document](https://skmtc.dev/huggingface/apis/hub-api-endpoints/revisions/bd17546f47b8?raw)