View reports about API rule compliance in API specifications

Governance reports are available with Postman Enterprise plans.

With the API Governance report dashboard, you can view metrics on API Governance rule compliance in your specifications in Spec Hub. As a Super Admin or API Governance Manager, you can gain insight into specifications violating your Governance rules, identify rules with frequent violations, and much more.

You can also view metrics for APIs in the Postman API Builder with specifications that violate your API Governance rules.

Access the report dashboard

To access the API Governance report dashboard, do the following:

Go to the Postman home screen.
Click API Governance in the left sidebar.
Click the Reports tab.

View report metrics

By default, the report dashboard shows metrics for public workspaces and internal workspaces everyone in your team can access in the All workspaces workspace group. To filter metrics by specific workspace groups, select the Workspace Groups dropdown list and select your workspace groups.

You can select any metric in the report dashboard to view more details in a dialog. This includes the API specifications included in the metric, the workspaces where they're located, the number of rules each specification violates, and more. You can also select any specification name, workspace name, Governance rule, and more to open them in a new tab. Select any column header to filter a table by that column's data, in alphabetical or numerical order.

The report metrics regularly refresh to show the latest results. Note that report metrics don't update in real time. See the last updated date in the upper right of the dashboard to learn when the last update occurred.

The report provides the following information:

Spec conformance status - The number of specifications with Governance rules applied. You can view the number of Conformant specifications with Info or Hint severity or no rule violations. You can also view the number of Non conformant specifications with Error or Warning severity.
Rule violations by severity - The number of Governance rules violations. You can view the breakdown of Governance rules violations by severity.
Spec conformance over time - The number of specifications with and without Governance rule violations, per month over the last 12 months.
Rule violations over time - The number of Governance rule violations by severity, per month over the last 12 months.
Rules and violations - The Governance rules violations, the rules' violations count, and the number of specifications violating each rule. Click View more to view all of the Governance rule violations.
Workspaces with most non-conformant Specs - The workspaces with the most specifications in violation of Governance rules. You can select View more actions next to a workspace group to filter the report dashboard by that workspace group or open the workspace group in a new tab.