Get all report folders

Use this resource to retrieve a list of all existing report folders for an authorized user.

Request

To retrieve the report folders, send a GET request to the endpoint defined below.

URL: /report/reports

Method: GET

Authorization: required

GET /ibis/rest/report/reports HTTP/1.1
Accept: */*
Host: localhost:8080

Query Parameters

The following table lists the query parameters for this request.

Name Description Required Allowed values

Name	Description	Required	Allowed values
`lang`	Enter the language of the report information.	no (default: `de`)	`de` or `en`

lang

Enter the language of the report information.

no (default: de)

de or en

Response

The response contains a list of folders or reports. For each folder, you can call the received URL in the folder’s href attribute to drill deeper into the report tree structure.

HTTP/1.1 200 OK
Content-Type: application/xml;charset=UTF-8

<?xml version="1.0" encoding="UTF-8"?>
<ReportsList>
    <Folder href="http://localhost:8000/ibis/rest/report/reports/System+load?lang=en" name="System load"/>
    <Folder href="http://localhost:8000/ibis/rest/report/reports/Modul-Ausf%C3%BChrungen?lang=en" name="Modul-Ausführungen"/>
    <Folder href="http://localhost:8000/ibis/rest/report/reports/Module+executions?lang=en" name="Module executions"/>
    <Folder href="http://localhost:8000/ibis/rest/report/reports/Workflow-Ausf%C3%BChrungen?lang=en" name="Workflow-Ausführungen"/>
    <Folder href="http://localhost:8000/ibis/rest/report/reports/Systemauslastung?lang=en" name="Systemauslastung"/>
    <Folder href="http://localhost:8000/ibis/rest/report/reports/Workflow+executions?lang=en" name="Workflow executions"/>
</ReportsList>

Errors

This request might return one of the following error codes:

Authorization Failed (401): Authorization with the given username and password failed. Please revisit both values and provide valid credentials.

<html>

    <head>
        <title>Status page</title>
    </head>

    <body style="font-family: sans-serif;">
        <p style="font-size: 1.2em;font-weight: bold;margin: 1em 0px;">Unauthorized</p>
        <p>The request requires user authentication</p>
        <p>You can get technical details <a
                href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.2">here</a>.<br>
            Please continue your visit at our <a href="/">home page</a>.
        </p>
    </body>
</html>

Server Error (500): Execution on the INUBIT server failed. Have a look into the response message, otherwise access to the INUBIT log is required to retrieve further information.
Service Unavailable (503): In maintenance mode the INUBIT server endpoint will not respond to incoming requests but return this error response. Once the maintenance mode is switched off the endpoint will respond normally.