API reference

Published reports

GET/PublishedReports/{id}
REST onlyFull license only

Returns the reports published to a client's Secure Communication Portal (SCP). Download each report with GET /Documents/{documentID}.

Parameters

Filter by the last days, or by a startDate / endDate range. With no filter, all published reports are returned.

NameInTypeDescription
idpathintegerrequiredClient id. 0 is not supported on this endpoint.
daysqueryintegeroptionalReports published in the last n days.
startDatequeryintegeroptionalStart of the publication date range, YYYYMMDD. Requires endDate.
endDatequeryintegeroptionalEnd of the publication date range, YYYYMMDD. Requires startDate and must not be earlier than it.
tenantIdquerystringoptionalTenant to query, from /Tenants. Default: your user's main tenant.

Example request

Response

FieldTypeDescription
namestringReport name, set by the publisher in CPA or SCP.
locationstringSCP folder the report is published in.
publicationDatestringPublication date.
reportDatestringReport date, set by the publisher.
expirationDatestringExpiration date, set by the publisher.
commentsstring | nullDescription or comments from the publisher.
documentIDstringDocument id. Pass it to GET /Documents/{documentId} to download the file.

Errors

StatusBody
400"The user does not have access to this client or the client does not exist." Also returned for id=0.
400"Both start and end date should be provided"
400"Invalid date format. Please provide date in yyyyMMdd format"
400"Start date should be less than end date"
400"The user does not have access to this tenant or the tenant does not exist."

Plus the common 401 and 429 responses. See Errors.