---
title: "Search request forms"
method: GET
path: "/api/request-form"
tags: ["Request Form"]
---

# Search request forms

`GET /api/request-form`

## Request

- Base URL: `https://na.api.immutacloud.com/marketplace`
- URL: `https://na.api.immutacloud.com/marketplace/api/request-form`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/immuta/apis/immuta-data-marketplace/docs/api/request-form/get.ts> (a function with typed inputs; its response is checked against the schema)

Search request forms in the marketplace using the provided filters

## Query parameters

- `offset` number
- `limit` number
- `sortOrder` 'asc' | 'desc'
- `sortBy` 'name' | 'createdAt' | 'updatedAt'
- `nameFilter` string
- `exactMatch` boolean

## Response `200`

- PaginatedRequestForm
  - `data` object[], required
    - `id` string, uuid, required
    - `name` string, required
    - `fields` union[], required
      - union
        - object
          - `id` string, uuid, required
          - `type` 'DROPDOWN' | 'CHECKBOXES', required
          - `label` string, required
          - `required` boolean
          - `options` object[], required
            - `value` string, required
        - object
          - `id` string, uuid, required
          - `type` 'SHORT_ANSWER', required
          - `label` string, required
          - `required` boolean
        - object
          - `id` string, uuid, required
          - `type` 'ACCESS_DURATION', required
          - `label` 'How long do you need access to this data?', required
          - `required` true, required
    - `policy` object, required
      - `version` string: Policy schema version
      - `rules` object[], required
        - `conditions` union, required
          - object
            - `all` unknown[], required
              - …
          - object
            - `any` unknown[], required
              - …
          - object
            - `not` unknown, required
        - `event` union, required
          - object
            - `type` 'approve', required
            - `params` object, required
              - …
          - object
            - `type` 'deny', required
            - `params` object, required
              - …
          - object
            - `type` 'review', required
            - `params` object, required
              - …
          - object
            - `type` 'dataProductPolicy', required
      - `defaultEvent` union, required
        - object
          - `type` 'approve', required
          - `params` object, required
            - `comment` string
            - `duration` number
            - `durationUnit` 'HOURS' | 'DAYS' | 'WEEKS' | 'MONTHS' | 'YEARS'
        - object
          - `type` 'deny', required
          - `params` object, required
            - `comment` string
        - object
          - `type` 'review', required
          - `params` object, required
            - `stages` union[], required: Array of stages for manual review
              - …
        - object
          - `type` 'dataProductPolicy', required
    - `dataUseAgreements` object[]
      - `id` string, uuid, required
      - `name` string, required: The name of data use agreement
      - `body` string, required: The contents of data use agreement
    - `createdBy` object, required: The user who originally created the request form
      - `globalUserId` string, uuid, required: Immuta global user ID
      - `name` string, required: Display name
    - `createdAt` union, required
      - string, date-time
      - string, date-time
    - `updatedBy` object, required: The user who last updated the request form
      - `globalUserId` string, uuid, required: Immuta global user ID
      - `name` string, required: Display name
    - `updatedAt` union, required
      - string, date-time
      - string, date-time
    - `version` string, cuid, required: The current version of the request form
    - `associatedDomains` string[], required: Domains associated with data products associated with this request form.
  - `meta` object, required
    - `offset` number
    - `limit` number
    - `totalCount` number, required
    - `pageCount` number, required
    - `currentPage` number, required
    - `totalPages` number, required

---

[API](https://skmtc.dev/immuta/apis/immuta-data-marketplace.md) - [All operations](https://skmtc.dev/immuta/apis/immuta-data-marketplace/llms.txt) - [OpenAPI document](https://skmtc.dev/immuta/apis/immuta-data-marketplace/revisions/622b396ca2d7?raw)