Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel1
maxLevel6
outlinetrue
stylenone
typelist
printabletrue

Overview

Custom Reports are also accessible from PCR-360’s API. This allows access for external systems or even from a web browser. Unlike other API Endpoints within PCR-360, the Custom Reports Endpoint is only available through GET calls.

API Request Format for Custom Reports

Below is the format for the GET Request to the Custom Reports Endpoint. Where [PCR-360 URL] is the web address to your Organization instance of PCR-360, [API KEY] is a valid API Key from within PCR-360 that has permission to access Custom Reports, and [REPORT IDENTIFIER] is the unique Report Identifier that can be found on the Admin > Reports > Custom Reports grid. The User can access the Report as an HTML or PDF file by supplying it to the call using the type as the [FORMAT].

Code Block
[PCR-360 URL]/api/[API KEY]/rpt/[REPORT IDENTIFIER].[FORMAT]

Example:

Code Block
https://pcr-360.com/api/abcdefg1234567/rpt/testReport.pdf

In addition, the User will need to add all required parameters for the report and any additional desired parameters the Report supports. The parameters and their values are sent using the paired format below.

Code Block
?[PARAMETER 1]=[VALUE 1]&[PARAMETER 2]=[VALUE 2]&[PARAMETER 3]=[VALUE 3]

Example:

Code Block
https://pcr-360.com/api/abcdefg1234567/rpt/testReport.pdf?param1=foo&param2=bar

Custom Reports API Permissions

image-20240813-164723.pngImage Removedimage-20240904-192643.pngImage Added

Since the The Custom Reports API only allows for running reports, the only permission for the Endpoint is a Read Permissionand retrieving reports. Any API key with the granted Read Permission can retrieve a Custom Report. Any API key with the granted Read Write Permission can run and retrieve any a Custom Report.