Formular anzeigen

Gibt die Metadaten eines einzelnen Formulars zurück. Die Antwort enthält keine Formular-Antworten und keine Empfängerdaten.

Request

GET /api/oauth/v2/resource/forms/{uuid}

Header

Header	Wert
Authorization	Bearer {access_token}

URL-Parameter

Parameter	Typ	Pflicht	Beschreibung
uuid	string	Ja	Eindeutige ID des Formulars

Response

Gelöschte und ersetzte Formulare werden ebenfalls geliefert. Ein gelöschtes Formular erkennst du an deleted: true.

Erfolg (200 OK)

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "title": "Anamnese",
    "customer": "f0e1d2c3-b4a5-6789-fedc-ba9876543210",
    "formCustomer": "b7c8d9e0-f1a2-4b3c-8d4e-5f6a7b8c9d0e",
    "replacedBy": null,
    "presetEdition": null,
    "createdAt": "2026-06-10T09:15:00+02:00",
    "updatedAt": "2026-06-10T09:20:00+02:00",
    "createdBy": "c3d4e5f6-a7b8-4c9d-8e0f-1a2b3c4d5e6f",
    "updatedBy": "c3d4e5f6-a7b8-4c9d-8e0f-1a2b3c4d5e6f",
    "deleted": false,
    "deletedAt": null,
    "deletedBy": null
  }
}

Response-Felder

Feld	Typ	Beschreibung
data.id	string (UUID)	Eindeutige ID des Formulars
data.title	string	Titel des Formulars
data.customer	string (UUID) | null	ID des zugeordneten Kunden
data.formCustomer	string (UUID) | null	ID des zugehörigen versendeten Formulars, siehe Versendetes Formular anzeigen
data.replacedBy	string (UUID) | null	ID des Formulars, das dieses Formular ersetzt hat
data.presetEdition	string | null	Auflage der Formular-Vorlage, aus der das Formular stammt
data.createdAt	string | null	Erstellt am (ISO 8601)
data.updatedAt	string | null	Zuletzt geändert am (ISO 8601)
data.createdBy	string (UUID) | null	ID des Benutzers, der das Formular erstellt hat
data.updatedBy	string (UUID) | null	ID des Benutzers, der das Formular zuletzt geändert hat
data.deleted	boolean	true, wenn das Formular gelöscht wurde
data.deletedAt	string | null	Gelöscht am (ISO 8601)
data.deletedBy	string (UUID) | null	ID des Benutzers, der das Formular gelöscht hat

Beispiele

bash

curl -X GET "https://my.offisy.at/api/oauth/v2/resource/forms/b2c3d4e5-f6a7-8901-bcde-f01234567890" \
  -H "Authorization: Bearer {access_token}"

Server

Client-ID

Client-Secret

Parameter

uuid *string

Zuerst Token anfordern

Mögliche Fehler

Status	Code	Beschreibung
401	invalid_client	Ungültiger oder fehlender Access Token
403	insufficient_scope	Scope forms nicht vorhanden
403	access_denied	Keine Leseberechtigung für Formulare, keine Formular-Lizenz oder das Formular gehört zu einem anderen Unternehmen
404	not_found	Formular nicht gefunden oder der zugeordnete Kunde liegt außerhalb der freigegebenen Mandanten