Get tasks by basic filter

The endpoint retrieves task using basic filter, with which the tasks to be retrieved can be pre-filtered based on roles.

Request

URL: /task/baseFilterTasks

Method: POST

Authorization: required

POST /ibis/rest/task/baseFilterTasks?user=root&enableDIN5007Sort=false&lang=en&inactiveFilter=true&inactiveFilterComparison=%21%3d&nameSorting=ascending&start=0&count=10&Unit%2F%40nameFilter=admin&Unit%2F%40nameFilterComparison=%3D&Unit%2F%40typeFilter=Role&Unit%2F%40typeFilterComparison=%3D&nameFilter=Area&nameFilterComparison=LIKE HTTP/1.1
Accept: application/xml
Host: localhost:8080

Body

[
  {
    "Unit/@name": {
      "Role": [
        "admin",
        "user"
      ]
    },
    "Unit/@type": "Role"
  }
]

Request Query Parameters

Name Description Required Allowed values

Name	Description	Required	Allowed values
`user`	Username	yes	Any existing username
`enableDIN5007Sort`	Enable German umlaut sorting	no	`true` or `false`
`start`	Start row in result (starts at 0)	no	Any positive integer
`count`	Number of rows	no	Any positive integer
`lang`	language	no (default: `de`)	`de` or `en`
`inactiveFilter`		no	`true` or `false`
`inactiveFilterComparison`		yes	LIKE \| = \| < \| > \| ⇐ \| >0
`nameSorting`	Sorting direction	no	`ascending` or `descending`
`nameFilter`	Filter by name	no	E.g.: admin
`nameFilterComparison`	Filter name comparison value	no	LIKE \| = \| < \| > \| ⇐ \| >0
Unit/@nameFilter	Filter by name	Yes if request body is empty json	E.g.: admin
Unit/@nameFilterComparison	Filter name comparison value	Yes if request body is empty	LIKE \| = \| < \| > \| ⇐ \| >0
Unit/@typeFilter	Filter by type	Yes if request body is empty	role
Unit/@typeFilterComparison	Filter type comparison value	Yes if request body is empty	LIKE \| = \| < \| > \| ⇐ \| >0
{field}FieldSorting	Custom field sorting	no	E.g.: `DummyField1typeFilter`=`ascending` or `descending`
{field}typeFilter	Custom field Filter type	no	E.g.: `DummyField1typeFilter`=`role`
{field}FieldFilter	Custom field filter	no	E.g.: `DummyField1fieldFilter`= `Custo`
{field}FieldFilterComparison	Filter type comparison value	no	LIKE \| = \| < \| > \| ⇐ \| >0

user

Username

yes

Any existing username

enableDIN5007Sort

Enable German umlaut sorting

true or false

start

Start row in result (starts at 0)

Any positive integer

count

Number of rows

Any positive integer

lang

language

no (default: de)

de or en

inactiveFilter

true or false

inactiveFilterComparison

yes

LIKE | = | < | > | ⇐ | >0

nameSorting

Sorting direction

ascending or descending

nameFilter

Filter by name

E.g.: admin

nameFilterComparison

Filter name comparison value

LIKE | = | < | > | ⇐ | >0

Unit/@nameFilter

Filter by name

Yes if request body is empty json

E.g.: admin

Unit/@nameFilterComparison

Filter name comparison value

Yes if request body is empty

LIKE | = | < | > | ⇐ | >0

Unit/@typeFilter

Filter by type

Yes if request body is empty

role

Unit/@typeFilterComparison

Filter type comparison value

Yes if request body is empty

LIKE | = | < | > | ⇐ | >0

{field}FieldSorting

Custom field sorting

E.g.: DummyField1typeFilter=ascending or descending

{field}typeFilter

Custom field Filter type

E.g.: DummyField1typeFilter=role

{field}FieldFilter

Custom field filter

E.g.: DummyField1fieldFilter= Custo

{field}FieldFilterComparison

Filter type comparison value

LIKE | = | < | > | ⇐ | >0

Response

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 1290

<Tasklist user="admin" total="4">
    <Task id="feaa6622-cee9-4158-94c7-eb7026b47477" process="20004" creation="1719763229788" expiration="1720022429788" action="Form" wait="0" test="true" client="admin">
        <Name xml:lang="de">Task_with_helpInfo</Name>
        <Description xml:lang="de">Task_with_helpInfo</Description>
        <Unit name="admin" type="Role" />
    </Task>
    <Task id="d43670e8-b922-40c9-a82e-63ba8e480a5e" process="20004" creation="1719763229700" expiration="1720022429700" action="Form" wait="0" client="admin" delegateRuleSetId="7ebee7fc-7f00-0101-218f-31c48a953396">
        <Name xml:lang="de">Task_Delegate_to_role</Name>
        <Description xml:lang="de">Task_Delegate_to_role</Description>
        <Unit name="user" type="Role" />
        <History user="admin" target="" timestamp="1719826596242" type="Delegation">
            <Description xml:lang="de"></Description>
        </History>
    </Task>
    <Task id="743933ef-a4bb-4511-8c52-9511b62b3987" process="20004" creation="1719763229745" expiration="1720022429745" action="Form" wait="0" client="admin" delegateRuleSetId="7efed0e6-7f00-0101-218f-31c46b1f3241">
        <Name xml:lang="de">Task_Delegate_to_all</Name>
        <Description xml:lang="de">Task_Delegate_to_all</Description>
        <Unit name="user" type="Role" />
        <History user="admin" target="" timestamp="1719826577116" type="Delegation">
            <Description xml:lang="de"></Description>
        </History>
    </Task>
    <Task id="590ed670-d656-4c85-8a5f-eb7d68c8966d" process="20004" creation="1719763229766" expiration="1720022429766" action="Form" wait="2" test="true" client="admin">
        <Name xml:lang="de">Task_follow_up_id</Name>
        <Description xml:lang="de">Task_follow_up_id</Description>
        <Unit name="admin" type="Role" />
    </Task>
</Tasklist>

Errors

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

<?xml version="1.0" encoding="UTF-8"?>
<ApiError>
    <statusCode>401</statusCode>
    <message>Unauthorized access</message>
    <path>/rest/endpoint</path>
    <timestamp>2025-06-07T14:21:11.781</timestamp>
</ApiError>

Resource Not Found (404): The 404 (Not Found) status code indicates that the requested endpoint or resource is unavailable or does not exist on the server.
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.

<?xml version="1.0" encoding="UTF-8"?>
<ApiError>
    <statusCode>500</statusCode>
    <message>Internal Server Error</message>
    <path>/rest/endpoint</path>
    <timestamp>2025-08-06T12:55:31.862</timestamp>
</ApiError>

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.

<?xml version="1.0" encoding="UTF-8"?>
<ApiError>
    <statusCode>503</statusCode>
    <message>Service Unavailable</message>
    <path>/rest/endpoint</path>
    <timestamp>2025-08-06T12:58:06.688</timestamp>
</ApiError>