Skip to main content

Get report IDs

Purpose​

This API allows users to retrieve all report IDs from a given collection.

Method & HTTP target resource​

GET /api/public/report

Request headers​

The following request headers have to be provided with every request:

HeaderConstraintsValue
AuthorizationREQUIRED*Authorization
  • Only required if not set as a query parameter

Query parameters​

The following query parameters have to be provided with every request:

ParameterConstraintsValue
access_tokenREQUIRED*Authorization
collectionIdREQUIREDThe ID of the Collection for which to retrieve the report IDs.
  • Only required if not set as a request header

Request body​

No request body is required.

Result​

The response contains a list of IDs of the reports existing in the collection with the given collection ID.

Response codes​

Possible HTTP response status codes:

CodeDescription
200Request successful.
401Secret incorrect or missing in HTTP Header. See Authorization on how to authenticate.
500Some error occurred while processing the request, best check the Optimize log.

Example​

Retrieve all report IDs from a collection​

Assuming you want to retrieve all report IDs in the collection with the ID 1234 and have configured the accessToken mySecret, this is what it would look like:

GET /api/public/report?collectionId=1234&access_token=mySecret

Response​

Status 200.

Response content​
[
{
"id": "9b0eb845-e8ed-4824-bd85-8cd69038f2f5"
},
{
"id": "1a866c7c-563e-4f6b-adf1-c4648531f7d4"
}
]