Aufgaben abrufen

Gibt eine paginierte Liste aller Aufgaben des Unternehmens zurück.

Request

GET /api/oauth/v2/resource/todos

Header

Header	Wert
Authorization	Bearer {access_token}

Query-Parameter

Parameter	Typ	Pflicht	Beschreibung
offset	integer	Nein	Startposition (Standard: 0)
limit	integer	Nein	Anzahl Ergebnisse (Standard: 50, Max: 200)
customerUuid	string	Nein	Filtert nach zugeordnetem Kunden. Erfordert zusätzlich den Scope customers
assignedToUuid	string	Nein	Filtert nach zugewiesenem Mitarbeiter. Erfordert zusätzlich den Scope users
statusUuid	string	Nein	Filtert nach Status
priority	string	Nein	Filtert nach Priorität (low, medium, normal, high, critical)
dueDateFrom	string	Nein	Fälligkeitsdatum ab (ISO-Datum oder ISO 8601, inklusive) – als Datum (2026-08-24) wird auf Tagesbeginn erweitert, mit Uhrzeit (2026-08-24T10:00:00, 2026-08-24T10:00:00+02:00, 2026-08-24T08:00:00.000Z) exakt übernommen
dueDateTo	string	Nein	Fälligkeitsdatum bis (ISO-Datum oder ISO 8601, inklusive) – als Datum (2026-08-24) wird auf Tagesende erweitert, mit Uhrzeit exakt übernommen
status	string	Nein	Filtert nach Status, kommagetrennt kombinierbar. Erlaubte Werte: active (nicht gelöscht), deleted. Standard: all (alle Werte). Siehe Konventionen.

Hinweis: Ein + im Zeitzonen-Offset von dueDateFrom/dueDateTo muss in der URL als %2B prozent-kodiert werden.

Hinweis: Ohne status-Filter sortiert dieser Endpoint nach interner ID aufsteigend, siehe Konventionen.

Hinweis: Die Filter statusUuid, assignedToUuid und customerUuid prüfen nicht, ob der referenzierte Datensatz zum selben Unternehmen gehört wie der Client. Verweist der Filter auf einen Datensatz, den der Client zwar lesen darf, der aber zu einem anderen Unternehmen gehört, liefert die Anfrage 200 OK mit einer entsprechend gefilterten (ggf. leeren) Liste.

Response

Erfolg (200 OK)

{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "number": "A-0001",
      "name": "Rückruf Patientin",
      "description": "Rückruf wegen Terminverschiebung",
      "priority": "normal",
      "dueDate": "2026-06-10T00:00:00+02:00",
      "status": "c3d4e5f6-a7b8-9012-cdef-345678901234",
      "tags": ["e5f6a7b8-9012-3456-ef01-567890123456"],
      "assignedTo": "d4c5b6a7-8901-2345-6789-0abcdef12345",
      "customer": "f0e1d2c3-b4a5-6789-fedc-ba9876543210",
      "createdAt": "2026-06-01T08:15:00+02:00",
      "updatedAt": "2026-06-08T11:42:00+02:00",
      "createdBy": "1a2b3c4d-5e6f-7890-abcd-ef1234567890",
      "updatedBy": "1a2b3c4d-5e6f-7890-abcd-ef1234567890",
      "deleted": false,
      "deletedAt": null
    }
  ],
  "meta": {
    "total": 42,
    "offset": 0,
    "limit": 50
  }
}

Response-Felder

Siehe Aufgabe anzeigen für die vollständige Feldbeschreibung des einzelnen Objekts.

Feld	Typ	Beschreibung
data	Array	Liste der Aufgaben
meta.total	integer	Gesamtanzahl der Aufgaben (unter Berücksichtigung des status-Filters)
meta.offset	integer	Aktuelle Startposition
meta.limit	integer	Anzahl der zurückgegebenen Einträge

Beispiele

bash

curl -X GET "https://my.offisy.at/api/oauth/v2/resource/todos?offset=0&limit=50&customerUuid=b2c3d4e5-f6a7-8901-bcde-f01234567890&assignedToUuid=b2c3d4e5-f6a7-8901-bcde-f01234567890&statusUuid=b2c3d4e5-f6a7-8901-bcde-f01234567890&priority=beispiel&dueDateFrom=2026-04-15T10%3A00%3A00&dueDateTo=2026-04-15T10%3A00%3A00&status=all" \
  -H "Authorization: Bearer {access_token}"

Server

Client-ID

Client-Secret

Parameter

offset integer

limit integer

customerUuid string

assignedToUuid string

statusUuid string

priority string

dueDateFrom string

dueDateTo string

status string

Zuerst Token anfordern

Mögliche Fehler

Status	Code	Beschreibung
400	validation_error	dueDateFrom und/oder dueDateTo ist kein gültiges ISO-8601-Datum bzw. -Datum/Zeit, dueDateFrom liegt nach dueDateTo, oder status enthält einen ungültigen Wert
401	invalid_client	Ungültiger oder fehlender Access Token
403	insufficient_scope	Scope todos nicht vorhanden, oder customerUuid/assignedToUuid verwendet ohne den zusätzlich erforderlichen Scope customers/users
404	not_found	statusUuid hat kein gültiges UUID-Format