Generate Governance Reports

Understand the parameters and response schema for the governance endpoints

This page describes the governance endpoint of the Immuta API and its request parameters used to generate governance reports.

Additional fields may be included in some responses you receive; however, these attributes

are for internal purposes and are therefore undocumented.

Default 9-minute timeout

Governance report queries will time out after 9 minutes to avoid overconsumption of resources. If your governance report was not generated because of this timeout, submit a support ticket to change the default setting.

Endpoints

Method	Endpoint	Description
GET	/governance/reports/user/allUserDataSources	Generate a report of all the data sources that all users are currently subscribed to.
GET	/governance/reports/user/allUserStatus	Generate a report of all current users and details about them.
GET	/governance/reports/user/{userId}/dataSource	Generate a report of the data sources the specified user is currently subscribed to.
GET	/governance/reports/user/{userId}/group	Generate a report of the groups the specified user is currently a member of.
GET	/governance/reports/user/{userId}/project	Generate a report of the projects the specified user is currently a member of.
GET	/governance/reports/user/{userId}/dataSourcePurposeAccess	Generate a report of all the purposes the user has accessed data for during the specified date range.
GET	/governance/reports/user/{userId}/dataSourceUserAccess	Generate a report of all the data sources the user has directly accessed during the specified date range.
GET	/governance/reports/user/{userId}/attribute	Generate a report of all the attributes the specified user currently has.
GET	/governance/reports/group/allGroupDataSourceAccess	Generate a report of all the data sources that any group is manually subscribed to.
GET	/governance/reports/group/{groupId}/user	Generate a report of all the users who are currently a member of the group.
GET	/governance/reports/group/{groupId}/dataSource	Generate a report of all the data sources that the group is manually subscribed to.
GET	/governance/reports/group/{groupId}/project	Generate a report of all the projects that the members of the group are currently subscribed to.
GET	/governance/reports/group/{groupId}/attribute	Generate a report of all the attributes currently assigned to the specified group.
GET	/governance/reports/project/{projectId}/user	Generate a report of all the data sources and members currently in the project.
GET	/governance/reports/project/{projectId}/dataSource	Generate a report of all the data sources currently in the specified project.
GET	/governance/reports/project/{projectId}/purpose	Generate a report of all the purposes currently assigned to the specified project.
GET	/governance/reports/dataSource/allDataSourceUsers	Generate a report of every user and group currently subscribed to any data source.
GET	/governance/reports/dataSource/{dataSourceId}/user	Generate a report of all the users and groups currently subscribed to the specified data source.
GET	/governance/reports/dataSource/{dataSourceId}/project	Generate a report of the projects that currently have the specified data source.
GET	/governance/reports/dataSource/{dataSourceId}/purpose	Generate a report of the purpose of every project that has the specified data source.
GET	/governance/reports/dataSource/{dataSourceId}/dataSourceUserAccess	Generate a report of the users that have accessed the data source during the specified date range.
GET	/governance/reports/dataSource/{dataSourceId}/dataSourcePurposeAccess	Generate a report of the purposes the data source has been accessed for during the specified date range.
GET	/governance/reports/dataSource/{dataSourceId}/subscriptionHistory	Generate a report of the users and groups that have been subscribed to the data source during the specified date range.
GET	/governance/reports/dataSource/{dataSourceId}/dataSourceSddScoring	Generate a report of data discovery scoring information for every column in the specified data source.
GET	/governance/reports/purpose/{purposeId}/user	Generate a report of all current members of the projects that use the purpose.
GET	/governance/reports/purpose/{purposeId}/dataSource	Generate a report of all current data sources of the projects that use the specified purpose.
GET	/governance/reports/purpose/{purposeId}/purpose	Generate a report of all other purposes currently combined with the specified purpose.
GET	/governance/reports/purpose/{purposeId}/project	Generate a report of projects with the specified purpose currently assigned.
GET	/governance/reports/purpose/{purposeId}/dataSourcePurposeAccess	Generate a report of data sources that have been accessed for the purpose during the specified date range.
GET	/governance/reports/tag/allDataSourceUserAccess	Generate a report of the users who have subscribed to data sources that were tagged with any tag since the specified start date.
GET	/governance/reports/tag/allProjects	Generate a report of the projects with data sources currently tagged with any tag.
GET	/governance/reports/tag/allUserDataSources	Generate a report of every data source currently tagged with any tag.
GET	/governance/reports/tag/{tagName}/dataSource	Generate a report of the data sources currently tagged with the specified tag.
GET	/governance/reports/tag/{tagName}/dataSourceUserAccess	Generate a report of users who have accessed data sources tagged with the specified tag during the specified date range.
GET	/governance/reports/tag/{tagName}/dataSourcePurposeAccess	Generate a report of the purposes that have been used to access data with the specified tag during the specified date range.
GET	/governance/reports/tag/{tagName}/project	Generate a report of the projects that have data sources currently tagged with this tag.
GET	/governance/reports/policy/{policyType}/dataSource	Generate a report of the data sources this data policy type is currently applied to.
GET	/governance/reports/globalPolicy/globalPolicyDisabled	Generate a report of all disabled global policies.
GET	/governance/reports/globalPolicy/globalPolicyInConflict	Generate a report of all policies currently in conflict.
GET	/governance/reports/globalPolicy/{policyId}/globalPolicyNotCertified	Generate a report of all data sources the specified policy has not been certified on.
GET	/governance/reports/globalPolicy/{policyId}/globalPolicyCertified	Generate a report of all data sources the specified policy has been certified on.
GET	/governance/reports/globalPolicy/{policyId}/dataSource	Generate a report of all data sources the specified global policy is applied to.
GET	/governance/reports/sdd/sddTagsOverview	Generate a report of all columns with tags applied by identification.

Example

GET /governance/reports/user/allUserDataSources

Generate a report of all the data sources that all users are currently subscribed to.

Query parameters

Parameter	Description	Required or optional
size integer	The number of results to return per page.	Optional
offset integer	The number of items from the beginning of the response to exclude. You can combine the offset and size parameters to return a specific set of report results.	Optional
sortField string	Used to sort results by field.	Optional
sortOrder string	Sorts results by order, which must be asc or desc. The default is asc.	Optional
export boolean	If true, the response will be provided in a downloadable csv file.	Optional