Requesting Access to a Data Product

Private preview: The Marketplace app is available to select accounts. Contact your Immuta representative for details.

If the data consumer is interested in using the data product, from the listing or the detailed view, they are able to request access (READ only):

• If there is no approval necessary, they will be automatically granted access after acknowledging the data use agreement and answering the required question(s).

• If there is approval necessary, it will kick off the approval flow. While in the approval flow, the Marketplace will display that data product listing as Pending.

Once the user has been approved access to the data product, the data product listing will show Approved. Data consumers are able to filter the data product list page by states to see what data products they already have access to.

Requesting access to a data product

The user can request access from the Marketplace app or through a deep link URL to the request access screen which is provided in the data product or constructed from scratch.

With the UI

1. From the Marketplace app click into the Data product you want access to, or click the request access URL for an external catalog.

2. Click the Request access button.

3. Review the information about existing policies on the Request Access page

4. Fill out your answer to the access question, if there is one (this is required even if there is no manually approval required).

5. Review and select the checkbox to the Data Use Agreement, if there is one.

6. Click Submit request.

With the API

Ensure you set the correct global segment and use a Marketplace-specific personal access token (PAT) when using the Marketplace API. See the Marketplace API docs for additional guidance or to download the OpenAPI YAML for your own client generation.

Request access to a data product

post

Create a new data access request for the specified data product

Authorizations

Path parameters

idstringrequired

Body

userstring · uuidrequired

Immuta global user ID of the user for whom access is being requested

formone of[]required

The data use agreement form

Responses

application/json

objectoptional

Access request with user and data product metadata

post

HTTPcURLJavaScriptPython

POST /marketplace/api/data-product/{id}/request HTTP/1.1
Host: na.api.immutacloud.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 88

{
  "user": "123e4567-e89b-12d3-a456-426614174000",
  "form": [
    {
      "id": "text",
      "response": "text"
    }
  ]
}

201Success

{
  "id": "text",
  "requestingUser": {
    "id": 1,
    "iamId": "text",
    "globalUserId": "123e4567-e89b-12d3-a456-426614174000",
    "username": "text",
    "name": "text"
  },
  "user": {
    "id": 1,
    "iamId": "text",
    "globalUserId": "123e4567-e89b-12d3-a456-426614174000",
    "username": "text",
    "name": "text"
  },
  "status": "PENDING",
  "createdAt": "2025-04-16T02:19:18.266Z",
  "updatedAt": "2025-04-16T02:19:18.266Z",
  "dataProduct": {
    "id": "text",
    "name": "Sales",
    "description": "All sales records from the current fiscal year"
  }
}