Endpoints / getTasks

getTasks

Cross-Lead Task-Übersicht

Alle Tasks (over alle Leads). Ersetzt Excel-Export 'mytask'. Sortiert default nach Reminder-Datum.

HTTP Request

POST https://dev.vitabyte.ch/v1/sales/getTasks

Auth basicAuth apiKey

Request Parameters

Filter (alle optional): ispatient (0/1), assignedTo (User-ID, 0 = nicht filtern), completed (false = nur offene), reminderFrom/reminderTo (YYYY-MM-DD).
orderBy: datetime, reminder (Default) oder priority.
Typische Fragen: „Was ist diese Woche fällig?" über assignedTo plus Reminder-Bereich; „Was ist überfällig?" über reminderTo = gestern.

Parameter	Pflicht	Typ	Beispiel / Default
`filter` {assignedTo, completed, dueFrom, dueTo, priority}	optional	object
`offset`	optional	integer	default: `0`
`limit`	optional	integer	default: `100`
`orderBy`	optional	string enum: reminder \| priority \| created	default: `reminder`
`orderDir`	optional	string enum: asc \| desc	default: `asc`

Response Parameters

Field	Typ	Beschreibung
`status`	boolean	true bei Erfolg, false bei Fehler
`msg`	string	Kurzbeschreibung des Resultats / der Fehlerursache
`result`		Endpoint-spezifisches Resultat. Typ je nach Endpoint (Object, Array, Skalar oder null).
`pagination`		Nur bei Listen-Endpoints gesetzt

Demo

Beispiel-Response handgepflegt — die OpenAPI-Spec liefert für diesen Endpoint noch kein Response-Example.

POST https://dev.vitabyte.ch/v1/sales/getTasks

Payload

{
    "filter": {
        "ispatient": 1,
        "assignedTo": 12,
        "completed": false,
        "reminderFrom": "2026-05-01",
        "reminderTo": "2026-12-31"
    },
    "offset": 0,
    "limit": 100,
    "orderBy": "reminder",
    "orderDir": "asc"
}

Response

{
    "status": true,
    "msg": "Success",
    "result": [
        {
            "historyId": 9877,
            "leadId": 12345,
            "lastname": "Mustermann",
            "firstname": "Max",
            "text": "Rückruf vereinbart",
            "reminderDate": "2026-05-25 00:00:00",
            "assignedTo": 12,
            "priority": 2,
            "completed": false,
            "created": "2026-05-18 14:35:00"
        },
        {
            "historyId": 9862,
            "leadId": 12341,
            "lastname": "Beispiel",
            "firstname": "Anna",
            "text": "Kostengutsprache nachfassen",
            "reminderDate": "2026-05-26 08:30:00",
            "assignedTo": 12,
            "priority": 1,
            "completed": false,
            "created": "2026-05-15 07:48:00"
        }
    ],
    "pagination": {
        "offset": 0,
        "limit": 100,
        "total": 2,
        "hasMore": false
    }
}