---
title: "Search access requests"
method: GET
path: "/api/access-request"
tags: ["Access Request"]
---

# Search access requests

`GET /api/access-request`

Search and filter access requests the current user can manage

## Query parameters

- `searchText` string
- `status` string[]
- `type` string[]
- `userIds` string[]
- `includeTemporary` boolean
- `expiration` boolean
- `role` string[]
- `dataProductId` union
  - string, cuid — The ID of the data product to filter requests by
  - string, uuid
- `assetId` string, uuid
- `assetType` string[]
- `targetType` string[]
- `reviewStatus` string[]
- `offset` number
- `limit` number
- `sortOrder` 'asc' | 'desc'
- `sortBy` 'status' | 'dataProduct' | 'createdAt' | 'updatedAt' | 'expiration'

## Response `200`

- PaginatedAccessRequest
  - `data` object[], required
    - `id` string, cuid, required
    - `requestingUser` object, required
      - `id` number, required
      - `iamId` string, required — ID of the IAM the user is associated with
      - `globalUserId` string, uuid, required — Immuta global user ID
      - `username` string, required — Username/login name for the user
      - `name` string, required — Display name
      - `email` string, nullable — Email address
      - `authorizations` object
    - `user` object, required
      - `id` number, required
      - `iamId` string, required — ID of the IAM the user is associated with
      - `globalUserId` string, uuid, required — Immuta global user ID
      - `username` string, required — Username/login name for the user
      - `name` string, required — Display name
      - `email` string, nullable — Email address
      - `authorizations` object
    - `formVersion` string, required
    - `form` unknown
    - `type` 'DATA_ACCESS' | 'MASKING_EXCEPTION', required
    - `metadata` unknown
    - `status` 'APPROVED' | 'CANCELED' | 'DENIED' | 'PENDING' | 'NONE' | 'PUBLISHER' | 'REVOKED' | 'EXPIRED', required
    - `expiration` string, date-time — When the temporary access will expire
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `dataProduct` object
      - `id` union, required
        - string, cuid
        - string, uuid
      - `name` string, required — Data product name
      - `description` string, nullable — Data product description
    - `asset` object
      - `id` union, required
        - string, cuid
        - string, uuid
      - `type` 'DATA_OBJECT', required
      - `name` string, required — Asset name
      - `metadata` object, required — Data object asset metadata
        - `subjectMatterExperts` object[]
          - `id` string, uuid, required — Immuta global user ID of the subject matter expert
          - `username` string
          - `name` string
        - `objectPath` string[], required
        - `technology` 'Snowflake' | 'PostgreSQL' | 'Databricks' | 'Glue' | 'MySQL' | 'Teradata' | 'MariaDB' | 'Oracle' | 'SQLServer' | 'Trino' | 'Redshift' | 'BigQuery'
        - `host` string
        - `port` integer
        - `legacyType` string
        - `dataSourceId` number
        - `description` string, nullable
        - `externalLink` string, nullable
  - `meta` object, required
    - `offset` number
    - `limit` number
    - `totalCount` number, required
    - `pageCount` number, required
    - `currentPage` number, required
    - `totalPages` number, required

---

[API](https://skmtc.net/immuta/apis/immuta-data-marketplace.md) · [All operations](https://skmtc.net/immuta/apis/immuta-data-marketplace/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/immuta/immuta-data-marketplace/revisions/622b396ca2d7/schema)