Zum Inhalt springen

Alle Formulare abrufen GET ​

Ruf alle Formulare in deinem Konto ab, die neuesten zuerst.

Endpunkt ​

GET https://api.pocketalert.app/v1/forms

Authentifizierung ​

Erforderlich

Füge eine dieser Header in deine Anfrage ein:

Anfrage ​

HeaderErforderlichBeschreibung
Token✅Dein API-Schlüssel
Authorization✅Bearer <jwt-token>

Beispielanfrage ​

bash
curl -X GET "https://api.pocketalert.app/v1/forms" \
  -H "Token: your-api-key"
javascript
const response = await fetch('https://api.pocketalert.app/v1/forms', {
  headers: { 'Token': 'your-api-key' }
});

const forms = await response.json();
forms.forEach((form) => console.log(form.name, `https://frms.click/${form.tid}`));
python
import requests

response = requests.get(
    'https://api.pocketalert.app/v1/forms',
    headers={'Token': 'your-api-key'}
)

for form in response.json():
    print(form['name'], f"https://frms.click/{form['tid']}")
php
$forms = Http::withHeaders([
    'Token' => 'your-api-key',
])->get('https://api.pocketalert.app/v1/forms')->json();

foreach ($forms as $form) {
    echo $form['name'].' https://frms.click/'.$form['tid'].PHP_EOL;
}

Antwort ​

Erfolgreiche Antwort ​

200 OK

Ein Array mit Formularen. Ein Konto ohne Formulare liefert [] zurück.

FeldTypBeschreibung
tidstringFormular-Kennung — der öffentliche Link ist https://frms.click/{tid}
namestringInterner Name, wird in deinem Dashboard angezeigt
fieldsarrayDie Felder des Formulars — siehe Formular erstellen
settingsobjectTitel, Texte und Design — siehe Formular erstellen
application_tidstringAnwendung, zu der die Eingaben gehören (leer, falls keine)
device_tidstringTID des Zielgeräts, all oder leer für alle Geräte
default_levelint | nullPrioritätsstufe für Eingaben (-2..2)
push_titlestringVorlage für den Push-Titel (leer bedeutet Form: {name})
allowed_originsarrayHosts, die das Formular einbetten und absenden dürfen (leer bedeutet überall)
max_responsesintObergrenze für Antworten, 0 für unbegrenzt
closes_atstring | nullSchlusszeitpunkt, RFC 3339 in UTC
closedbooleanOb das Formular aktuell keine Eingaben mehr annimmt
is_activebooleanDer Ein-/Aus-Schalter des Eigentümers
submissions_countintBisher eingegangene Antworten
last_submission_atstringLetzte Antwort, in der Zeitzone deines Kontos
created_atstringErstellungsdatum, in der Zeitzone deines Kontos
json
[
  {
    "tid": "vml19aihrga216gt8apc5e3m9",
    "name": "Contact form",
    "fields": [
      { "id": "name", "type": "text", "label": "Name", "placeholder": "Jane Doe", "required": true },
      { "id": "email", "type": "email", "label": "Email", "placeholder": "[email protected]", "required": true }
    ],
    "settings": {
      "title": "Get in touch",
      "top_text": "Leave your details and we will get back to you shortly.",
      "primary_color": "#3f5cad",
      "submit": { "text": "Submit", "color": "", "size": "md" }
    },
    "application_tid": "qm47b9pzxzx7applfd0",
    "device_tid": "",
    "default_level": null,
    "push_title": "New lead: {Name}",
    "allowed_origins": ["example.com"],
    "max_responses": 0,
    "closes_at": null,
    "closed": false,
    "is_active": true,
    "submissions_count": 12,
    "last_submission_at": "23.09.2026 14:05:11",
    "created_at": "20.09.2026 09:12:40"
  }
]

Fehlerantworten ​

StatusBeschreibung
401Nicht autorisiert — Token ungültig oder fehlt
500Formulare konnten nicht geladen werden

Pocket Alert Dokumentation