Data-API: Datensätze per REST lesen

Die Data-API liefert alle veröffentlichten Einträge eines Datentyps als JSON. Sie läuft unter der Adresse deines Dashboards – in den Beispielen https://<dashboard-domain>.

Authentifizierung

Authorization: Bearer <dein-token>

Das Token braucht den Scope data:<handle>:read.

Liste abrufen

curl -H "Authorization: Bearer $ARETIS_TOKEN" \
  "https://<dashboard-domain>/api/data/team?limit=20"

Parameter	Standard	Beschreibung
`limit`	50	Anzahl Einträge, max. 100
`cursor`	0	Versatz für die nächste Seite – Wert aus `pagination.next`
`expand`	–	Bis zu drei Referenzfelder, kommagetrennt, werden aufgelöst
`<feldkennung>=<wert>`	–	Filtert auf exakte Übereinstimmung, z. B. `?abteilung=vertrieb`

Antwort

{
  "data": [
    {
      "id": "8f1c2a3b-…",
      "slug": "anna-mueller",
      "created_at": "2026-09-01T08:12:44Z",
      "updated_at": "2026-10-14T15:03:10Z",
      "name": "Anna Müller",
      "position": "Geschäftsführerin",
      "abteilung": "vertrieb",
      "_references": { "standort": ["b2d4…"] }
    }
  ],
  "pagination": { "limit": 20, "cursor": 0, "next": 20 }
}

Einträge sind nach ihrer Position sortiert. Liefert eine Seite weniger Einträge als limit, bist du am Ende.

Einzelnen Eintrag abrufen

GET /api/data/team/8f1c2a3b-…

Referenzen auflösen

GET /api/data/team?expand=standort

Ohne expand stehen Referenzen nur als IDs in _references. Mit expand wird das Feld durch die verknüpften Einträge ersetzt. Nur Felder vom Typ Referenz sind erlaubt.

Fehler

Status	Bedeutung
`400`	Ungültiges `expand` (mehr als drei Felder oder kein Referenzfeld)
`401`	`unauthorized` (kein Token) oder `invalid token`
`403`	`forbidden` – Token hat keinen passenden Scope
`404`	Datentyp oder Eintrag nicht gefunden
`429`	Mehr als 120 Anfragen in 60 Sekunden pro Unternehmen

Entwürfe und archivierte Einträge liefert die API nie. Für Änderungen in Echtzeit nutze Webhooks statt häufiger Abfragen.