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

# Search request forms

`GET /api/request-form`

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.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)