View reports on usage, security, and billing in Postman

Postman generates reports that enable you to visualize data for how your team uses Postman. These reports give you insights into the state of your APIs, including tests, documentation, and monitoring coverage. They also enable you to track performance and SLA adherence.

Access your reports in your Postman reports dashboard.

The Postman reports dashboard

Getting started with reports

Reports are available on all Postman Enterprise plans. The Public workspace metrics report is available on all Postman plans.

Reports give information about various aspects of your team and plan, including member and content activity, API security, and billing and overage information.

To view your reports dashboard:

  • Select Home in the Postman header, then select Reports from the team information section on the left.

To access a specific API's report, do the following:

  1. On the report dashboard, select Content activity > View report by API.

  2. Search for the API name, or scroll through the list to find it.

    You can also access the report for a specific API by going to the API's overview page and select Reports.

Report availability

Postman generates reports periodically but not in real time. You might experience a delay of four to six hours before report data is available. Postman displays the last update time at the bottom of the report dashboard sidebar.

Report permissions

In a given report, you can only access report data that's available to you based on the level of access you have for the relevant collection, API, element, mock server, or monitor. For more information about element-based roles, see Defining roles.

If you don't have permission to access an element, aggregate visualizations will still display the correct number of elements but won't provide you with the element name or other relevant information for the specific element.

Report message that restricted data is hidden

Exploring reports and report data

To explore reports:

  • Select items in the report dashboard sidebar.

    Some report items have a link that opens another related report. For example, on the Uptime chart in the Summary report, there is a link to open the Team APIs report.

To explore data in a report:

  • Hover over a data point to show the data point's value.

    reports data point
  • Select a data point to drill down and view more details. Sort the table by selecting a column heading. Hover over a table row and select the arrow to go to a related report or element.

    reports drill down

Troubleshooting

Reports have the following limitations:

  • You can't download or export your reports.
  • Postman reports only track data sent through the request builder, and not data sent through Newman, collection runs, or monitors. However, failed test runs do generate reports using collection runs.
  • You can't view the details of elements you don't have access to.

If there isn't any data in your reports, or your data is incomplete (for example, you have empty response times or sizes) this may be due to one of the following reasons:

  • The data hasn't refreshed yet. Check after four to six hours.
  • You might not have linked a collection to your API.
  • You might not have sent a request. Or you might have run requests from monitoring, collection runs, or Newman, but not from the request builder in Postman.
  • Postman isn't syncing. Check your network connection and visit the Postman Status Page to learn whether there's an outage.

Last modified: 2023/06/15