VolunteerShift

Ehrenamt6 EndpunkteTimeTracking / VolunteerShift

Helfer-Schichten auflisten

GET/api/time/volunteer_shift

Query-Parameter

`id`integer
`deleted`boolean	Standardwert: false
`name`string
`start`string
`end`string
`event`string
`created`string
`searchString`string	Text, nach dem in der Liste gesucht wird
`orderFieldName`string	Name des Bestellfelds
`orderFieldSort`string	SortiermodusErlaubt: `DESCASC`
`page`integer	Seite der Liste
`pageSize`integer	Anzahl der Einträge je Seite
`withMaxPageNumber`string	gibt die Anzahl verfügbarer Seiten als Header zurück, wenn dies gesetzt ist

Antworten

200Liefert eine Liste der VolunteerShift-Objekte.array<VolunteerShift>

Felder anzeigen (16)

effective_credited_minutesinteger
Minuten, die einem anwesenden Helfer gutgeschrieben werden.
signed_up_countinteger
Helfer, die angemeldet sind oder teilgenommen haben - stornierte Anmeldungen geben ihren Platz wieder frei.
open_slotsinteger
Freie Plätze, null wenn die Schicht kein Limit hat.
idinteger
Primärschlüssel der Ehrenamtsschicht. Interne ID.
namestring
Name der Ehrenamtsschicht.
descriptionstring
Beschreibung der Ehrenamtsschicht.
locationstring
Ort, an dem die Ehrenamtsschicht stattfindet.
startstring (date-time)
Beginn des ehrenamtlichen Dienstes.
endstring (date-time)
Ende der Ehrenamtsschicht.
required_helpersinteger
Benötigte Helfer. 0 = kein Limit.
credited_minutesinteger
Minuten je anwesendem Helfer gutgeschrieben. null = die Länge der Schicht.
signup_untilstring (date-time)
Die Anmeldung endet zu diesem Zeitpunkt. null = bis zum Beginn des Dienstes.
eventBaseEvent10
Event, zu dem die Helferschicht gehört.
Felder anzeigen (45)
- ticketSeatingPlanIdinteger
  ID des Sitzplans, auch für die öffentliche Serialisierung und die Kunden-Serialisierung.
- bib_numbers_enabledboolean
- timing_enabledboolean
- idinteger
  Primärschlüssel der Veranstaltung. Interne ID.
- public_subtitlestring
  Untertitel, der in der öffentlichen Veranstaltungsliste angezeigt wird.
- event_typestring
  Art des Events, zum Beispiel Kurs, Fahrt oder Turnier.
- event_people_limitinteger
  maximale Anzahl Personen, die an der Veranstaltung teilnehmen können
- event_people_min_limitinteger
  minimale Anzahl Personen, die an der Veranstaltung teilnehmen müssen
- hide_event_people_limitboolean
  eine Einstellung, um die Teilnehmerbegrenzung der Veranstaltung in der Frontend-Oberfläche auszublenden
- has_wait_listboolean
  Die Veranstaltung hat eine Warteliste, sobald sie voll ist.
- wait_list_confirmation_requiredboolean
  Teilnehmende von der Warteliste müssen ihren Platz bestätigen.
- trial_enabledboolean
  Schnuppertermine (Schnuppern) werden für dieses Event angeboten. Standardmäßig deaktiviert: Das Event muss sich dafür aktiv entscheiden, die Regel stammt aus trialPolicy, der Kategorie des Events oder der Standardregel.
- can_sign_up_for_main_eventboolean
  Teilnehmende dürfen sich für die Hauptveranstaltung anmelden.
- only_sign_up_for_main_eventboolean
  Teilnehmende dürfen sich nur für die Hauptveranstaltung anmelden, nicht für Unterveranstaltungen.
- start_timestring (date-time)
  Beginn der Veranstaltung.
- end_timestring (date-time)
  Ende der Veranstaltung.
- require_addressboolean
  Teilnehmende müssen bei der Anmeldung eine Adresse angeben.
- require_contactboolean
  Teilnehmende müssen bei der Anmeldung Kontaktdaten angeben.
- require_billingboolean
  Teilnehmende müssen bei der Anmeldung Rechnungsdaten angeben.
- allow_direct_billingboolean
- require_direct_billingboolean
- allow_budget_sign_upboolean
- require_ageboolean
  Teilnehmende müssen bei der Anmeldung ihr Alter angeben.
- require_grade_levelboolean
  Teilnehmende müssen bei der Anmeldung ihre Schulstufe angeben.
- require_free_note_field_idsstring
  IDs der Freitext-Notizfelder, die Teilnehmer ausfüllen müssen.
- generate_new_bookingsboolean
  Buchungen werden für den Veranstaltungsplan automatisch erzeugt.
- generate_new_bookings_v2boolean
  Buchungen werden mit der zweiten Version des Plan-Generators erzeugt.
- generate_ignore_sys_calendarboolean
  Erzeugte Buchungen ignorieren die Feiertage des Systemkalenders.
- generate_hour_startstring (date-time)
  Startzeit des Tages für erzeugte Buchungen.
- generate_hour_endstring (date-time)
  Endzeit des Tages für generierte Buchungen.
- generate_day_of_weekinteger
  Wochentag für erzeugte Buchungen.
- bitmask_days_of_weekinteger
  Bitmask-Wert der Wochentage, an denen die Veranstaltung stattfindet
- bitmask_hours_startinteger
  Bitmask-Wert der Stunden, zu denen eine Veranstaltung beginnt
- summarized_date_timesstring
  Zeichenkette mit den Wochentagen und Stunden, zu denen eine Veranstaltung beginnt
- customer_detail_ctastring
  In der Kunden-App auf der Veranstaltungsdetailseite angezeigter Call-to-Action-Text.
- customer_badgestring
  Badge-Text, der in der Kunden-App bei der Veranstaltung angezeigt wird.
- bib_number_modestring
  Vergabeart der Startnummern: OFF, MANUAL, AUTOMATIC oder BATCH. Greift nur, wenn der Event-Typ Startnummern hat (enableBibNumbers).
- timing_gun_startstring (date-time)
  Startschuss; ohne Wert gilt startTime.
- timing_public_liveboolean
  Live-Zeitnahme-Ergebnisse sind öffentlich.
- timing_gps_trackingboolean
  GPS-Tracking der Teilnehmer ist für die Zeitmessung aktiviert.
- timing_self_check_inboolean
  Teilnehmende können sich für die Zeitmessung selbst einchecken.
- ticket_sales_enabledboolean
  Ticketverkauf statt Anmeldung: Teilnehmer kaufen Tickets (Ticketarten = Event-Preise mit Kontingent und Verkaufszeitraum), jedes Ticket bekommt einen Code für den Check-in. Greift nur mit der Einstellung event_ticket_sales_enabled.
- ticket_max_per_orderinteger
  Höchstzahl Tickets je Bestellung; ohne Wert gilt event_ticket_max_per_order_default.
- ticket_personalizedboolean
  Personalisierte Tickets: jedes Ticket braucht den Namen des Teilnehmers. Sonst laufen alle Tickets einer Bestellung auf den Namen des Käufers.
- ticket_seatingboolean
  Platzwahl beim Ticketverkauf: jedes Ticket bekommt einen freien Platz aus dem Saalplan des Raums (BaseBookable::ticketSeatingPlan); die Ticketart kann auf eine Zone (ticketSeatZone) beschränkt sein. Greift nur mit der Einstellung event_ticket_seating_enabled.
deletedboolean
Die Ehrenamts-Schicht wird gelöscht.
createdstring (date-time)
Zeitpunkt, zu dem die Ehrenamtsschicht angelegt wurde.
updatedstring (date-time)
Zeitpunkt, zu dem die Ehrenamtsschicht zuletzt geändert wurde.

Anfrage

curl --request GET \
  --url https://eure-instanz.iw-erp.de/api/time/volunteer_shift \
  --header 'x-iw-jwt-token: <TOKEN>'

const options = {method: 'GET', headers: {'x-iw-jwt-token': '<TOKEN>'}};

fetch('https://eure-instanz.iw-erp.de/api/time/volunteer_shift', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://eure-instanz.iw-erp.de/api/time/volunteer_shift"

headers = {"x-iw-jwt-token": "<TOKEN>"}

response = requests.get(url, headers=headers)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://eure-instanz.iw-erp.de/api/time/volunteer_shift', [
  'headers' => [
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/time/volunteer_shift"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/time/volunteer_shift")
  .get()
  .addHeader("x-iw-jwt-token", "<TOKEN>")
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://eure-instanz.iw-erp.de/api/time/volunteer_shift"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-iw-jwt-token", "<TOKEN>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart mit dem Package iw_erp_api

import 'package:iw_erp_api/clients/volunteer_shift_controller.dart';
import 'package:iw_erp_api/logic/iw_api_state.dart';

IwApiState().host = 'eure-instanz.iw-erp.de';
IwApiState().currentJwtApiToken = '<TOKEN>';

final result = await VolunteerShiftController.getAll();
if (result.success) {
  print(result.data);
}

Antwort 200 application/json

[
  {
    "id": 42,
    "name": "Beispiel",
    "description": "Text",
    "effective_credited_minutes": 1,
    "signed_up_count": 1,
    "open_slots": 1,
    "location": "string",
    "start": "2026-10-15T09:30:00+02:00",
    "end": "2026-10-15T09:30:00+02:00",
    "required_helpers": 1
  }
]

Helferschicht hinzufügen

POST/api/time/volunteer_shift

Request-Body application/json

dataVolunteerShift2
Felder anzeigen (10)
- namestring
  Name der Ehrenamtsschicht.
- descriptionstring
  Beschreibung der Ehrenamtsschicht.
- locationstring
  Ort, an dem die Ehrenamtsschicht stattfindet.
- startstring (date-time)
  Beginn des ehrenamtlichen Dienstes.
- endstring (date-time)
  Ende der Ehrenamtsschicht.
- required_helpersinteger
  Benötigte Helfer. 0 = kein Limit.
- credited_minutesinteger
  Minuten je anwesendem Helfer gutgeschrieben. null = die Länge der Schicht.
- signup_untilstring (date-time)
  Die Anmeldung endet zu diesem Zeitpunkt. null = bis zum Beginn des Dienstes.
- eventBaseEvent12
  Event, zu dem die Helferschicht gehört.
- deletedboolean
  Die Ehrenamts-Schicht wird gelöscht.

Antworten

200VolunteerShift neu anlegenVolunteerShift

Felder anzeigen (16)

effective_credited_minutesinteger
Minuten, die einem anwesenden Helfer gutgeschrieben werden.
signed_up_countinteger
Helfer, die angemeldet sind oder teilgenommen haben - stornierte Anmeldungen geben ihren Platz wieder frei.
open_slotsinteger
Freie Plätze, null wenn die Schicht kein Limit hat.
idinteger
Primärschlüssel der Ehrenamtsschicht. Interne ID.
namestring
Name der Ehrenamtsschicht.
descriptionstring
Beschreibung der Ehrenamtsschicht.
locationstring
Ort, an dem die Ehrenamtsschicht stattfindet.
startstring (date-time)
Beginn des ehrenamtlichen Dienstes.
endstring (date-time)
Ende der Ehrenamtsschicht.
required_helpersinteger
Benötigte Helfer. 0 = kein Limit.
credited_minutesinteger
Minuten je anwesendem Helfer gutgeschrieben. null = die Länge der Schicht.
signup_untilstring (date-time)
Die Anmeldung endet zu diesem Zeitpunkt. null = bis zum Beginn des Dienstes.
eventBaseEvent10
Event, zu dem die Helferschicht gehört.
Felder anzeigen (45)
- ticketSeatingPlanIdinteger
  ID des Sitzplans, auch für die öffentliche Serialisierung und die Kunden-Serialisierung.
- bib_numbers_enabledboolean
- timing_enabledboolean
- idinteger
  Primärschlüssel der Veranstaltung. Interne ID.
- public_subtitlestring
  Untertitel, der in der öffentlichen Veranstaltungsliste angezeigt wird.
- event_typestring
  Art des Events, zum Beispiel Kurs, Fahrt oder Turnier.
- event_people_limitinteger
  maximale Anzahl Personen, die an der Veranstaltung teilnehmen können
- event_people_min_limitinteger
  minimale Anzahl Personen, die an der Veranstaltung teilnehmen müssen
- hide_event_people_limitboolean
  eine Einstellung, um die Teilnehmerbegrenzung der Veranstaltung in der Frontend-Oberfläche auszublenden
- has_wait_listboolean
  Die Veranstaltung hat eine Warteliste, sobald sie voll ist.
- wait_list_confirmation_requiredboolean
  Teilnehmende von der Warteliste müssen ihren Platz bestätigen.
- trial_enabledboolean
  Schnuppertermine (Schnuppern) werden für dieses Event angeboten. Standardmäßig deaktiviert: Das Event muss sich dafür aktiv entscheiden, die Regel stammt aus trialPolicy, der Kategorie des Events oder der Standardregel.
- can_sign_up_for_main_eventboolean
  Teilnehmende dürfen sich für die Hauptveranstaltung anmelden.
- only_sign_up_for_main_eventboolean
  Teilnehmende dürfen sich nur für die Hauptveranstaltung anmelden, nicht für Unterveranstaltungen.
- start_timestring (date-time)
  Beginn der Veranstaltung.
- end_timestring (date-time)
  Ende der Veranstaltung.
- require_addressboolean
  Teilnehmende müssen bei der Anmeldung eine Adresse angeben.
- require_contactboolean
  Teilnehmende müssen bei der Anmeldung Kontaktdaten angeben.
- require_billingboolean
  Teilnehmende müssen bei der Anmeldung Rechnungsdaten angeben.
- allow_direct_billingboolean
- require_direct_billingboolean
- allow_budget_sign_upboolean
- require_ageboolean
  Teilnehmende müssen bei der Anmeldung ihr Alter angeben.
- require_grade_levelboolean
  Teilnehmende müssen bei der Anmeldung ihre Schulstufe angeben.
- require_free_note_field_idsstring
  IDs der Freitext-Notizfelder, die Teilnehmer ausfüllen müssen.
- generate_new_bookingsboolean
  Buchungen werden für den Veranstaltungsplan automatisch erzeugt.
- generate_new_bookings_v2boolean
  Buchungen werden mit der zweiten Version des Plan-Generators erzeugt.
- generate_ignore_sys_calendarboolean
  Erzeugte Buchungen ignorieren die Feiertage des Systemkalenders.
- generate_hour_startstring (date-time)
  Startzeit des Tages für erzeugte Buchungen.
- generate_hour_endstring (date-time)
  Endzeit des Tages für generierte Buchungen.
- generate_day_of_weekinteger
  Wochentag für erzeugte Buchungen.
- bitmask_days_of_weekinteger
  Bitmask-Wert der Wochentage, an denen die Veranstaltung stattfindet
- bitmask_hours_startinteger
  Bitmask-Wert der Stunden, zu denen eine Veranstaltung beginnt
- summarized_date_timesstring
  Zeichenkette mit den Wochentagen und Stunden, zu denen eine Veranstaltung beginnt
- customer_detail_ctastring
  In der Kunden-App auf der Veranstaltungsdetailseite angezeigter Call-to-Action-Text.
- customer_badgestring
  Badge-Text, der in der Kunden-App bei der Veranstaltung angezeigt wird.
- bib_number_modestring
  Vergabeart der Startnummern: OFF, MANUAL, AUTOMATIC oder BATCH. Greift nur, wenn der Event-Typ Startnummern hat (enableBibNumbers).
- timing_gun_startstring (date-time)
  Startschuss; ohne Wert gilt startTime.
- timing_public_liveboolean
  Live-Zeitnahme-Ergebnisse sind öffentlich.
- timing_gps_trackingboolean
  GPS-Tracking der Teilnehmer ist für die Zeitmessung aktiviert.
- timing_self_check_inboolean
  Teilnehmende können sich für die Zeitmessung selbst einchecken.
- ticket_sales_enabledboolean
  Ticketverkauf statt Anmeldung: Teilnehmer kaufen Tickets (Ticketarten = Event-Preise mit Kontingent und Verkaufszeitraum), jedes Ticket bekommt einen Code für den Check-in. Greift nur mit der Einstellung event_ticket_sales_enabled.
- ticket_max_per_orderinteger
  Höchstzahl Tickets je Bestellung; ohne Wert gilt event_ticket_max_per_order_default.
- ticket_personalizedboolean
  Personalisierte Tickets: jedes Ticket braucht den Namen des Teilnehmers. Sonst laufen alle Tickets einer Bestellung auf den Namen des Käufers.
- ticket_seatingboolean
  Platzwahl beim Ticketverkauf: jedes Ticket bekommt einen freien Platz aus dem Saalplan des Raums (BaseBookable::ticketSeatingPlan); die Ticketart kann auf eine Zone (ticketSeatZone) beschränkt sein. Greift nur mit der Einstellung event_ticket_seating_enabled.
deletedboolean
Die Ehrenamts-Schicht wird gelöscht.
createdstring (date-time)
Zeitpunkt, zu dem die Ehrenamtsschicht angelegt wurde.
updatedstring (date-time)
Zeitpunkt, zu dem die Ehrenamtsschicht zuletzt geändert wurde.

Anfrage

curl --request POST \
  --url https://eure-instanz.iw-erp.de/api/time/volunteer_shift \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '
{
  "data": {
    "name": "Beispiel",
    "description": "Text",
    "location": "string",
    "start": "2026-10-15T09:30:00+02:00",
    "end": "2026-10-15T09:30:00+02:00",
    "required_helpers": 1
  }
}
'

const options = {
  method: 'POST',
  headers: {'x-iw-jwt-token': '<TOKEN>', 'content-type': 'application/json'},
  body: JSON.stringify({
    data: {
      name: 'Beispiel',
      description: 'Text',
      location: 'string',
      start: '2026-10-15T09:30:00+02:00',
      end: '2026-10-15T09:30:00+02:00',
      required_helpers: 1
    }
  })
};

fetch('https://eure-instanz.iw-erp.de/api/time/volunteer_shift', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://eure-instanz.iw-erp.de/api/time/volunteer_shift"

payload = { "data": {
    "name": "Beispiel",
    "description": "Text",
    "location": "string",
    "start": "2026-10-15T09:30:00+02:00",
    "end": "2026-10-15T09:30:00+02:00",
    "required_helpers": 1
  } }
headers = {
  "x-iw-jwt-token": "<TOKEN>",
  "content-type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://eure-instanz.iw-erp.de/api/time/volunteer_shift', [
  'body' => '{"data":{"name":"Beispiel","description":"Text","location":"string","start":"2026-10-15T09:30:00+02:00","end":"2026-10-15T09:30:00+02:00","required_helpers":1}}',
  'headers' => [
    'content-type' => 'application/json',
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/time/volunteer_shift"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
  Content = new StringContent("{\"data\":{\"name\":\"Beispiel\",\"description\":\"Text\",\"location\":\"string\",\"start\":\"2026-10-15T09:30:00+02:00\",\"end\":\"2026-10-15T09:30:00+02:00\",\"required_helpers\":1}}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"data\":{\"name\":\"Beispiel\",\"description\":\"Text\",\"location\":\"string\",\"start\":\"2026-10-15T09:30:00+02:00\",\"end\":\"2026-10-15T09:30:00+02:00\",\"required_helpers\":1}}");
Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/time/volunteer_shift")
  .post(body)
  .addHeader("x-iw-jwt-token", "<TOKEN>")
  .addHeader("content-type", "application/json")
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://eure-instanz.iw-erp.de/api/time/volunteer_shift"

	payload := strings.NewReader("{\"data\":{\"name\":\"Beispiel\",\"description\":\"Text\",\"location\":\"string\",\"start\":\"2026-10-15T09:30:00+02:00\",\"end\":\"2026-10-15T09:30:00+02:00\",\"required_helpers\":1}}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-iw-jwt-token", "<TOKEN>")
	req.Header.Add("content-type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart mit dem Package iw_erp_api

import 'package:iw_erp_api/clients/volunteer_shift_controller.dart';
import 'package:iw_erp_api/logic/iw_api_state.dart';
import 'package:iw_erp_api/model/volunteer_shift.dart';

IwApiState().host = 'eure-instanz.iw-erp.de';
IwApiState().currentJwtApiToken = '<TOKEN>';

final result = await VolunteerShiftController.post(VolunteerShift.fromJson({
  "name": "Beispiel",
  "description": "Text",
  "location": "string",
  "start": "2026-10-15T09:30:00+02:00",
  "end": "2026-10-15T09:30:00+02:00",
  "required_helpers": 1
}));
if (result.success) {
  print(result.data);
}

Antwort 200 application/json

{
  "id": 42,
  "name": "Beispiel",
  "description": "Text",
  "effective_credited_minutes": 1,
  "signed_up_count": 1,
  "open_slots": 1,
  "location": "string",
  "start": "2026-10-15T09:30:00+02:00",
  "end": "2026-10-15T09:30:00+02:00",
  "required_helpers": 1
}

Einzelne Helferschicht abrufen

GET/api/time/volunteer_shift/{id}

Pfad-Parameter

idPflichtstring

Antworten

200Liefert ein einzelnes VolunteerShift-Objekt.VolunteerShift

Felder anzeigen (16)

effective_credited_minutesinteger
Minuten, die einem anwesenden Helfer gutgeschrieben werden.
signed_up_countinteger
Helfer, die angemeldet sind oder teilgenommen haben - stornierte Anmeldungen geben ihren Platz wieder frei.
open_slotsinteger
Freie Plätze, null wenn die Schicht kein Limit hat.
idinteger
Primärschlüssel der Ehrenamtsschicht. Interne ID.
namestring
Name der Ehrenamtsschicht.
descriptionstring
Beschreibung der Ehrenamtsschicht.
locationstring
Ort, an dem die Ehrenamtsschicht stattfindet.
startstring (date-time)
Beginn des ehrenamtlichen Dienstes.
endstring (date-time)
Ende der Ehrenamtsschicht.
required_helpersinteger
Benötigte Helfer. 0 = kein Limit.
credited_minutesinteger
Minuten je anwesendem Helfer gutgeschrieben. null = die Länge der Schicht.
signup_untilstring (date-time)
Die Anmeldung endet zu diesem Zeitpunkt. null = bis zum Beginn des Dienstes.
eventBaseEvent10
Event, zu dem die Helferschicht gehört.
Felder anzeigen (45)
- ticketSeatingPlanIdinteger
  ID des Sitzplans, auch für die öffentliche Serialisierung und die Kunden-Serialisierung.
- bib_numbers_enabledboolean
- timing_enabledboolean
- idinteger
  Primärschlüssel der Veranstaltung. Interne ID.
- public_subtitlestring
  Untertitel, der in der öffentlichen Veranstaltungsliste angezeigt wird.
- event_typestring
  Art des Events, zum Beispiel Kurs, Fahrt oder Turnier.
- event_people_limitinteger
  maximale Anzahl Personen, die an der Veranstaltung teilnehmen können
- event_people_min_limitinteger
  minimale Anzahl Personen, die an der Veranstaltung teilnehmen müssen
- hide_event_people_limitboolean
  eine Einstellung, um die Teilnehmerbegrenzung der Veranstaltung in der Frontend-Oberfläche auszublenden
- has_wait_listboolean
  Die Veranstaltung hat eine Warteliste, sobald sie voll ist.
- wait_list_confirmation_requiredboolean
  Teilnehmende von der Warteliste müssen ihren Platz bestätigen.
- trial_enabledboolean
  Schnuppertermine (Schnuppern) werden für dieses Event angeboten. Standardmäßig deaktiviert: Das Event muss sich dafür aktiv entscheiden, die Regel stammt aus trialPolicy, der Kategorie des Events oder der Standardregel.
- can_sign_up_for_main_eventboolean
  Teilnehmende dürfen sich für die Hauptveranstaltung anmelden.
- only_sign_up_for_main_eventboolean
  Teilnehmende dürfen sich nur für die Hauptveranstaltung anmelden, nicht für Unterveranstaltungen.
- start_timestring (date-time)
  Beginn der Veranstaltung.
- end_timestring (date-time)
  Ende der Veranstaltung.
- require_addressboolean
  Teilnehmende müssen bei der Anmeldung eine Adresse angeben.
- require_contactboolean
  Teilnehmende müssen bei der Anmeldung Kontaktdaten angeben.
- require_billingboolean
  Teilnehmende müssen bei der Anmeldung Rechnungsdaten angeben.
- allow_direct_billingboolean
- require_direct_billingboolean
- allow_budget_sign_upboolean
- require_ageboolean
  Teilnehmende müssen bei der Anmeldung ihr Alter angeben.
- require_grade_levelboolean
  Teilnehmende müssen bei der Anmeldung ihre Schulstufe angeben.
- require_free_note_field_idsstring
  IDs der Freitext-Notizfelder, die Teilnehmer ausfüllen müssen.
- generate_new_bookingsboolean
  Buchungen werden für den Veranstaltungsplan automatisch erzeugt.
- generate_new_bookings_v2boolean
  Buchungen werden mit der zweiten Version des Plan-Generators erzeugt.
- generate_ignore_sys_calendarboolean
  Erzeugte Buchungen ignorieren die Feiertage des Systemkalenders.
- generate_hour_startstring (date-time)
  Startzeit des Tages für erzeugte Buchungen.
- generate_hour_endstring (date-time)
  Endzeit des Tages für generierte Buchungen.
- generate_day_of_weekinteger
  Wochentag für erzeugte Buchungen.
- bitmask_days_of_weekinteger
  Bitmask-Wert der Wochentage, an denen die Veranstaltung stattfindet
- bitmask_hours_startinteger
  Bitmask-Wert der Stunden, zu denen eine Veranstaltung beginnt
- summarized_date_timesstring
  Zeichenkette mit den Wochentagen und Stunden, zu denen eine Veranstaltung beginnt
- customer_detail_ctastring
  In der Kunden-App auf der Veranstaltungsdetailseite angezeigter Call-to-Action-Text.
- customer_badgestring
  Badge-Text, der in der Kunden-App bei der Veranstaltung angezeigt wird.
- bib_number_modestring
  Vergabeart der Startnummern: OFF, MANUAL, AUTOMATIC oder BATCH. Greift nur, wenn der Event-Typ Startnummern hat (enableBibNumbers).
- timing_gun_startstring (date-time)
  Startschuss; ohne Wert gilt startTime.
- timing_public_liveboolean
  Live-Zeitnahme-Ergebnisse sind öffentlich.
- timing_gps_trackingboolean
  GPS-Tracking der Teilnehmer ist für die Zeitmessung aktiviert.
- timing_self_check_inboolean
  Teilnehmende können sich für die Zeitmessung selbst einchecken.
- ticket_sales_enabledboolean
  Ticketverkauf statt Anmeldung: Teilnehmer kaufen Tickets (Ticketarten = Event-Preise mit Kontingent und Verkaufszeitraum), jedes Ticket bekommt einen Code für den Check-in. Greift nur mit der Einstellung event_ticket_sales_enabled.
- ticket_max_per_orderinteger
  Höchstzahl Tickets je Bestellung; ohne Wert gilt event_ticket_max_per_order_default.
- ticket_personalizedboolean
  Personalisierte Tickets: jedes Ticket braucht den Namen des Teilnehmers. Sonst laufen alle Tickets einer Bestellung auf den Namen des Käufers.
- ticket_seatingboolean
  Platzwahl beim Ticketverkauf: jedes Ticket bekommt einen freien Platz aus dem Saalplan des Raums (BaseBookable::ticketSeatingPlan); die Ticketart kann auf eine Zone (ticketSeatZone) beschränkt sein. Greift nur mit der Einstellung event_ticket_seating_enabled.
deletedboolean
Die Ehrenamts-Schicht wird gelöscht.
createdstring (date-time)
Zeitpunkt, zu dem die Ehrenamtsschicht angelegt wurde.
updatedstring (date-time)
Zeitpunkt, zu dem die Ehrenamtsschicht zuletzt geändert wurde.

Anfrage

curl --request GET \
  --url https://eure-instanz.iw-erp.de/api/time/volunteer_shift/42 \
  --header 'x-iw-jwt-token: <TOKEN>'

const options = {method: 'GET', headers: {'x-iw-jwt-token': '<TOKEN>'}};

fetch('https://eure-instanz.iw-erp.de/api/time/volunteer_shift/42', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://eure-instanz.iw-erp.de/api/time/volunteer_shift/42"

headers = {"x-iw-jwt-token": "<TOKEN>"}

response = requests.get(url, headers=headers)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://eure-instanz.iw-erp.de/api/time/volunteer_shift/42', [
  'headers' => [
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/time/volunteer_shift/42"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/time/volunteer_shift/42")
  .get()
  .addHeader("x-iw-jwt-token", "<TOKEN>")
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://eure-instanz.iw-erp.de/api/time/volunteer_shift/42"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-iw-jwt-token", "<TOKEN>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart mit dem Package iw_erp_api

import 'package:iw_erp_api/clients/volunteer_shift_controller.dart';
import 'package:iw_erp_api/logic/iw_api_state.dart';

IwApiState().host = 'eure-instanz.iw-erp.de';
IwApiState().currentJwtApiToken = '<TOKEN>';

final result = await VolunteerShiftController.get('42');
if (result.success) {
  print(result.data);
}

Antwort 200 application/json

{
  "id": 42,
  "name": "Beispiel",
  "description": "Text",
  "effective_credited_minutes": 1,
  "signed_up_count": 1,
  "open_slots": 1,
  "location": "string",
  "start": "2026-10-15T09:30:00+02:00",
  "end": "2026-10-15T09:30:00+02:00",
  "required_helpers": 1
}

Helferschicht aktualisieren

PUT/api/time/volunteer_shift/{id}

Pfad-Parameter

idPflichtstring

Request-Body application/json

dataVolunteerShift2
Felder anzeigen (10)
- namestring
  Name der Ehrenamtsschicht.
- descriptionstring
  Beschreibung der Ehrenamtsschicht.
- locationstring
  Ort, an dem die Ehrenamtsschicht stattfindet.
- startstring (date-time)
  Beginn des ehrenamtlichen Dienstes.
- endstring (date-time)
  Ende der Ehrenamtsschicht.
- required_helpersinteger
  Benötigte Helfer. 0 = kein Limit.
- credited_minutesinteger
  Minuten je anwesendem Helfer gutgeschrieben. null = die Länge der Schicht.
- signup_untilstring (date-time)
  Die Anmeldung endet zu diesem Zeitpunkt. null = bis zum Beginn des Dienstes.
- eventBaseEvent12
  Event, zu dem die Helferschicht gehört.
- deletedboolean
  Die Ehrenamts-Schicht wird gelöscht.

Antworten

200VolunteerShift aktualisierenVolunteerShift

Felder anzeigen (16)

effective_credited_minutesinteger
Minuten, die einem anwesenden Helfer gutgeschrieben werden.
signed_up_countinteger
Helfer, die angemeldet sind oder teilgenommen haben - stornierte Anmeldungen geben ihren Platz wieder frei.
open_slotsinteger
Freie Plätze, null wenn die Schicht kein Limit hat.
idinteger
Primärschlüssel der Ehrenamtsschicht. Interne ID.
namestring
Name der Ehrenamtsschicht.
descriptionstring
Beschreibung der Ehrenamtsschicht.
locationstring
Ort, an dem die Ehrenamtsschicht stattfindet.
startstring (date-time)
Beginn des ehrenamtlichen Dienstes.
endstring (date-time)
Ende der Ehrenamtsschicht.
required_helpersinteger
Benötigte Helfer. 0 = kein Limit.
credited_minutesinteger
Minuten je anwesendem Helfer gutgeschrieben. null = die Länge der Schicht.
signup_untilstring (date-time)
Die Anmeldung endet zu diesem Zeitpunkt. null = bis zum Beginn des Dienstes.
eventBaseEvent10
Event, zu dem die Helferschicht gehört.
Felder anzeigen (45)
- ticketSeatingPlanIdinteger
  ID des Sitzplans, auch für die öffentliche Serialisierung und die Kunden-Serialisierung.
- bib_numbers_enabledboolean
- timing_enabledboolean
- idinteger
  Primärschlüssel der Veranstaltung. Interne ID.
- public_subtitlestring
  Untertitel, der in der öffentlichen Veranstaltungsliste angezeigt wird.
- event_typestring
  Art des Events, zum Beispiel Kurs, Fahrt oder Turnier.
- event_people_limitinteger
  maximale Anzahl Personen, die an der Veranstaltung teilnehmen können
- event_people_min_limitinteger
  minimale Anzahl Personen, die an der Veranstaltung teilnehmen müssen
- hide_event_people_limitboolean
  eine Einstellung, um die Teilnehmerbegrenzung der Veranstaltung in der Frontend-Oberfläche auszublenden
- has_wait_listboolean
  Die Veranstaltung hat eine Warteliste, sobald sie voll ist.
- wait_list_confirmation_requiredboolean
  Teilnehmende von der Warteliste müssen ihren Platz bestätigen.
- trial_enabledboolean
  Schnuppertermine (Schnuppern) werden für dieses Event angeboten. Standardmäßig deaktiviert: Das Event muss sich dafür aktiv entscheiden, die Regel stammt aus trialPolicy, der Kategorie des Events oder der Standardregel.
- can_sign_up_for_main_eventboolean
  Teilnehmende dürfen sich für die Hauptveranstaltung anmelden.
- only_sign_up_for_main_eventboolean
  Teilnehmende dürfen sich nur für die Hauptveranstaltung anmelden, nicht für Unterveranstaltungen.
- start_timestring (date-time)
  Beginn der Veranstaltung.
- end_timestring (date-time)
  Ende der Veranstaltung.
- require_addressboolean
  Teilnehmende müssen bei der Anmeldung eine Adresse angeben.
- require_contactboolean
  Teilnehmende müssen bei der Anmeldung Kontaktdaten angeben.
- require_billingboolean
  Teilnehmende müssen bei der Anmeldung Rechnungsdaten angeben.
- allow_direct_billingboolean
- require_direct_billingboolean
- allow_budget_sign_upboolean
- require_ageboolean
  Teilnehmende müssen bei der Anmeldung ihr Alter angeben.
- require_grade_levelboolean
  Teilnehmende müssen bei der Anmeldung ihre Schulstufe angeben.
- require_free_note_field_idsstring
  IDs der Freitext-Notizfelder, die Teilnehmer ausfüllen müssen.
- generate_new_bookingsboolean
  Buchungen werden für den Veranstaltungsplan automatisch erzeugt.
- generate_new_bookings_v2boolean
  Buchungen werden mit der zweiten Version des Plan-Generators erzeugt.
- generate_ignore_sys_calendarboolean
  Erzeugte Buchungen ignorieren die Feiertage des Systemkalenders.
- generate_hour_startstring (date-time)
  Startzeit des Tages für erzeugte Buchungen.
- generate_hour_endstring (date-time)
  Endzeit des Tages für generierte Buchungen.
- generate_day_of_weekinteger
  Wochentag für erzeugte Buchungen.
- bitmask_days_of_weekinteger
  Bitmask-Wert der Wochentage, an denen die Veranstaltung stattfindet
- bitmask_hours_startinteger
  Bitmask-Wert der Stunden, zu denen eine Veranstaltung beginnt
- summarized_date_timesstring
  Zeichenkette mit den Wochentagen und Stunden, zu denen eine Veranstaltung beginnt
- customer_detail_ctastring
  In der Kunden-App auf der Veranstaltungsdetailseite angezeigter Call-to-Action-Text.
- customer_badgestring
  Badge-Text, der in der Kunden-App bei der Veranstaltung angezeigt wird.
- bib_number_modestring
  Vergabeart der Startnummern: OFF, MANUAL, AUTOMATIC oder BATCH. Greift nur, wenn der Event-Typ Startnummern hat (enableBibNumbers).
- timing_gun_startstring (date-time)
  Startschuss; ohne Wert gilt startTime.
- timing_public_liveboolean
  Live-Zeitnahme-Ergebnisse sind öffentlich.
- timing_gps_trackingboolean
  GPS-Tracking der Teilnehmer ist für die Zeitmessung aktiviert.
- timing_self_check_inboolean
  Teilnehmende können sich für die Zeitmessung selbst einchecken.
- ticket_sales_enabledboolean
  Ticketverkauf statt Anmeldung: Teilnehmer kaufen Tickets (Ticketarten = Event-Preise mit Kontingent und Verkaufszeitraum), jedes Ticket bekommt einen Code für den Check-in. Greift nur mit der Einstellung event_ticket_sales_enabled.
- ticket_max_per_orderinteger
  Höchstzahl Tickets je Bestellung; ohne Wert gilt event_ticket_max_per_order_default.
- ticket_personalizedboolean
  Personalisierte Tickets: jedes Ticket braucht den Namen des Teilnehmers. Sonst laufen alle Tickets einer Bestellung auf den Namen des Käufers.
- ticket_seatingboolean
  Platzwahl beim Ticketverkauf: jedes Ticket bekommt einen freien Platz aus dem Saalplan des Raums (BaseBookable::ticketSeatingPlan); die Ticketart kann auf eine Zone (ticketSeatZone) beschränkt sein. Greift nur mit der Einstellung event_ticket_seating_enabled.
deletedboolean
Die Ehrenamts-Schicht wird gelöscht.
createdstring (date-time)
Zeitpunkt, zu dem die Ehrenamtsschicht angelegt wurde.
updatedstring (date-time)
Zeitpunkt, zu dem die Ehrenamtsschicht zuletzt geändert wurde.

Anfrage

curl --request PUT \
  --url https://eure-instanz.iw-erp.de/api/time/volunteer_shift/42 \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '
{
  "data": {
    "name": "Beispiel",
    "description": "Text",
    "location": "string",
    "start": "2026-10-15T09:30:00+02:00",
    "end": "2026-10-15T09:30:00+02:00",
    "required_helpers": 1
  }
}
'

const options = {
  method: 'PUT',
  headers: {'x-iw-jwt-token': '<TOKEN>', 'content-type': 'application/json'},
  body: JSON.stringify({
    data: {
      name: 'Beispiel',
      description: 'Text',
      location: 'string',
      start: '2026-10-15T09:30:00+02:00',
      end: '2026-10-15T09:30:00+02:00',
      required_helpers: 1
    }
  })
};

fetch('https://eure-instanz.iw-erp.de/api/time/volunteer_shift/42', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://eure-instanz.iw-erp.de/api/time/volunteer_shift/42"

payload = { "data": {
    "name": "Beispiel",
    "description": "Text",
    "location": "string",
    "start": "2026-10-15T09:30:00+02:00",
    "end": "2026-10-15T09:30:00+02:00",
    "required_helpers": 1
  } }
headers = {
  "x-iw-jwt-token": "<TOKEN>",
  "content-type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('PUT', 'https://eure-instanz.iw-erp.de/api/time/volunteer_shift/42', [
  'body' => '{"data":{"name":"Beispiel","description":"Text","location":"string","start":"2026-10-15T09:30:00+02:00","end":"2026-10-15T09:30:00+02:00","required_helpers":1}}',
  'headers' => [
    'content-type' => 'application/json',
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Put,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/time/volunteer_shift/42"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
  Content = new StringContent("{\"data\":{\"name\":\"Beispiel\",\"description\":\"Text\",\"location\":\"string\",\"start\":\"2026-10-15T09:30:00+02:00\",\"end\":\"2026-10-15T09:30:00+02:00\",\"required_helpers\":1}}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"data\":{\"name\":\"Beispiel\",\"description\":\"Text\",\"location\":\"string\",\"start\":\"2026-10-15T09:30:00+02:00\",\"end\":\"2026-10-15T09:30:00+02:00\",\"required_helpers\":1}}");
Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/time/volunteer_shift/42")
  .put(body)
  .addHeader("x-iw-jwt-token", "<TOKEN>")
  .addHeader("content-type", "application/json")
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://eure-instanz.iw-erp.de/api/time/volunteer_shift/42"

	payload := strings.NewReader("{\"data\":{\"name\":\"Beispiel\",\"description\":\"Text\",\"location\":\"string\",\"start\":\"2026-10-15T09:30:00+02:00\",\"end\":\"2026-10-15T09:30:00+02:00\",\"required_helpers\":1}}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("x-iw-jwt-token", "<TOKEN>")
	req.Header.Add("content-type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart mit dem Package iw_erp_api

import 'package:iw_erp_api/clients/volunteer_shift_controller.dart';
import 'package:iw_erp_api/logic/iw_api_state.dart';
import 'package:iw_erp_api/model/volunteer_shift.dart';

IwApiState().host = 'eure-instanz.iw-erp.de';
IwApiState().currentJwtApiToken = '<TOKEN>';

final result = await VolunteerShiftController.put(VolunteerShift.fromJson({
  "name": "Beispiel",
  "description": "Text",
  "location": "string",
  "start": "2026-10-15T09:30:00+02:00",
  "end": "2026-10-15T09:30:00+02:00",
  "required_helpers": 1
}));
if (result.success) {
  print(result.data);
}

Antwort 200 application/json

{
  "id": 42,
  "name": "Beispiel",
  "description": "Text",
  "effective_credited_minutes": 1,
  "signed_up_count": 1,
  "open_slots": 1,
  "location": "string",
  "start": "2026-10-15T09:30:00+02:00",
  "end": "2026-10-15T09:30:00+02:00",
  "required_helpers": 1
}

Helferschicht aktualisieren

PATCH/api/time/volunteer_shift/{id}

Pfad-Parameter

idPflichtstring

Request-Body application/json

dataVolunteerShift2
Felder anzeigen (10)
- namestring
  Name der Ehrenamtsschicht.
- descriptionstring
  Beschreibung der Ehrenamtsschicht.
- locationstring
  Ort, an dem die Ehrenamtsschicht stattfindet.
- startstring (date-time)
  Beginn des ehrenamtlichen Dienstes.
- endstring (date-time)
  Ende der Ehrenamtsschicht.
- required_helpersinteger
  Benötigte Helfer. 0 = kein Limit.
- credited_minutesinteger
  Minuten je anwesendem Helfer gutgeschrieben. null = die Länge der Schicht.
- signup_untilstring (date-time)
  Die Anmeldung endet zu diesem Zeitpunkt. null = bis zum Beginn des Dienstes.
- eventBaseEvent12
  Event, zu dem die Helferschicht gehört.
- deletedboolean
  Die Ehrenamts-Schicht wird gelöscht.

Antworten

200VolunteerShift aktualisierenVolunteerShift

Felder anzeigen (16)

effective_credited_minutesinteger
Minuten, die einem anwesenden Helfer gutgeschrieben werden.
signed_up_countinteger
Helfer, die angemeldet sind oder teilgenommen haben - stornierte Anmeldungen geben ihren Platz wieder frei.
open_slotsinteger
Freie Plätze, null wenn die Schicht kein Limit hat.
idinteger
Primärschlüssel der Ehrenamtsschicht. Interne ID.
namestring
Name der Ehrenamtsschicht.
descriptionstring
Beschreibung der Ehrenamtsschicht.
locationstring
Ort, an dem die Ehrenamtsschicht stattfindet.
startstring (date-time)
Beginn des ehrenamtlichen Dienstes.
endstring (date-time)
Ende der Ehrenamtsschicht.
required_helpersinteger
Benötigte Helfer. 0 = kein Limit.
credited_minutesinteger
Minuten je anwesendem Helfer gutgeschrieben. null = die Länge der Schicht.
signup_untilstring (date-time)
Die Anmeldung endet zu diesem Zeitpunkt. null = bis zum Beginn des Dienstes.
eventBaseEvent10
Event, zu dem die Helferschicht gehört.
Felder anzeigen (45)
- ticketSeatingPlanIdinteger
  ID des Sitzplans, auch für die öffentliche Serialisierung und die Kunden-Serialisierung.
- bib_numbers_enabledboolean
- timing_enabledboolean
- idinteger
  Primärschlüssel der Veranstaltung. Interne ID.
- public_subtitlestring
  Untertitel, der in der öffentlichen Veranstaltungsliste angezeigt wird.
- event_typestring
  Art des Events, zum Beispiel Kurs, Fahrt oder Turnier.
- event_people_limitinteger
  maximale Anzahl Personen, die an der Veranstaltung teilnehmen können
- event_people_min_limitinteger
  minimale Anzahl Personen, die an der Veranstaltung teilnehmen müssen
- hide_event_people_limitboolean
  eine Einstellung, um die Teilnehmerbegrenzung der Veranstaltung in der Frontend-Oberfläche auszublenden
- has_wait_listboolean
  Die Veranstaltung hat eine Warteliste, sobald sie voll ist.
- wait_list_confirmation_requiredboolean
  Teilnehmende von der Warteliste müssen ihren Platz bestätigen.
- trial_enabledboolean
  Schnuppertermine (Schnuppern) werden für dieses Event angeboten. Standardmäßig deaktiviert: Das Event muss sich dafür aktiv entscheiden, die Regel stammt aus trialPolicy, der Kategorie des Events oder der Standardregel.
- can_sign_up_for_main_eventboolean
  Teilnehmende dürfen sich für die Hauptveranstaltung anmelden.
- only_sign_up_for_main_eventboolean
  Teilnehmende dürfen sich nur für die Hauptveranstaltung anmelden, nicht für Unterveranstaltungen.
- start_timestring (date-time)
  Beginn der Veranstaltung.
- end_timestring (date-time)
  Ende der Veranstaltung.
- require_addressboolean
  Teilnehmende müssen bei der Anmeldung eine Adresse angeben.
- require_contactboolean
  Teilnehmende müssen bei der Anmeldung Kontaktdaten angeben.
- require_billingboolean
  Teilnehmende müssen bei der Anmeldung Rechnungsdaten angeben.
- allow_direct_billingboolean
- require_direct_billingboolean
- allow_budget_sign_upboolean
- require_ageboolean
  Teilnehmende müssen bei der Anmeldung ihr Alter angeben.
- require_grade_levelboolean
  Teilnehmende müssen bei der Anmeldung ihre Schulstufe angeben.
- require_free_note_field_idsstring
  IDs der Freitext-Notizfelder, die Teilnehmer ausfüllen müssen.
- generate_new_bookingsboolean
  Buchungen werden für den Veranstaltungsplan automatisch erzeugt.
- generate_new_bookings_v2boolean
  Buchungen werden mit der zweiten Version des Plan-Generators erzeugt.
- generate_ignore_sys_calendarboolean
  Erzeugte Buchungen ignorieren die Feiertage des Systemkalenders.
- generate_hour_startstring (date-time)
  Startzeit des Tages für erzeugte Buchungen.
- generate_hour_endstring (date-time)
  Endzeit des Tages für generierte Buchungen.
- generate_day_of_weekinteger
  Wochentag für erzeugte Buchungen.
- bitmask_days_of_weekinteger
  Bitmask-Wert der Wochentage, an denen die Veranstaltung stattfindet
- bitmask_hours_startinteger
  Bitmask-Wert der Stunden, zu denen eine Veranstaltung beginnt
- summarized_date_timesstring
  Zeichenkette mit den Wochentagen und Stunden, zu denen eine Veranstaltung beginnt
- customer_detail_ctastring
  In der Kunden-App auf der Veranstaltungsdetailseite angezeigter Call-to-Action-Text.
- customer_badgestring
  Badge-Text, der in der Kunden-App bei der Veranstaltung angezeigt wird.
- bib_number_modestring
  Vergabeart der Startnummern: OFF, MANUAL, AUTOMATIC oder BATCH. Greift nur, wenn der Event-Typ Startnummern hat (enableBibNumbers).
- timing_gun_startstring (date-time)
  Startschuss; ohne Wert gilt startTime.
- timing_public_liveboolean
  Live-Zeitnahme-Ergebnisse sind öffentlich.
- timing_gps_trackingboolean
  GPS-Tracking der Teilnehmer ist für die Zeitmessung aktiviert.
- timing_self_check_inboolean
  Teilnehmende können sich für die Zeitmessung selbst einchecken.
- ticket_sales_enabledboolean
  Ticketverkauf statt Anmeldung: Teilnehmer kaufen Tickets (Ticketarten = Event-Preise mit Kontingent und Verkaufszeitraum), jedes Ticket bekommt einen Code für den Check-in. Greift nur mit der Einstellung event_ticket_sales_enabled.
- ticket_max_per_orderinteger
  Höchstzahl Tickets je Bestellung; ohne Wert gilt event_ticket_max_per_order_default.
- ticket_personalizedboolean
  Personalisierte Tickets: jedes Ticket braucht den Namen des Teilnehmers. Sonst laufen alle Tickets einer Bestellung auf den Namen des Käufers.
- ticket_seatingboolean
  Platzwahl beim Ticketverkauf: jedes Ticket bekommt einen freien Platz aus dem Saalplan des Raums (BaseBookable::ticketSeatingPlan); die Ticketart kann auf eine Zone (ticketSeatZone) beschränkt sein. Greift nur mit der Einstellung event_ticket_seating_enabled.
deletedboolean
Die Ehrenamts-Schicht wird gelöscht.
createdstring (date-time)
Zeitpunkt, zu dem die Ehrenamtsschicht angelegt wurde.
updatedstring (date-time)
Zeitpunkt, zu dem die Ehrenamtsschicht zuletzt geändert wurde.

Anfrage

curl --request PATCH \
  --url https://eure-instanz.iw-erp.de/api/time/volunteer_shift/42 \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '
{
  "data": {
    "name": "Beispiel",
    "description": "Text",
    "location": "string",
    "start": "2026-10-15T09:30:00+02:00",
    "end": "2026-10-15T09:30:00+02:00",
    "required_helpers": 1
  }
}
'

const options = {
  method: 'PATCH',
  headers: {'x-iw-jwt-token': '<TOKEN>', 'content-type': 'application/json'},
  body: JSON.stringify({
    data: {
      name: 'Beispiel',
      description: 'Text',
      location: 'string',
      start: '2026-10-15T09:30:00+02:00',
      end: '2026-10-15T09:30:00+02:00',
      required_helpers: 1
    }
  })
};

fetch('https://eure-instanz.iw-erp.de/api/time/volunteer_shift/42', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://eure-instanz.iw-erp.de/api/time/volunteer_shift/42"

payload = { "data": {
    "name": "Beispiel",
    "description": "Text",
    "location": "string",
    "start": "2026-10-15T09:30:00+02:00",
    "end": "2026-10-15T09:30:00+02:00",
    "required_helpers": 1
  } }
headers = {
  "x-iw-jwt-token": "<TOKEN>",
  "content-type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('PATCH', 'https://eure-instanz.iw-erp.de/api/time/volunteer_shift/42', [
  'body' => '{"data":{"name":"Beispiel","description":"Text","location":"string","start":"2026-10-15T09:30:00+02:00","end":"2026-10-15T09:30:00+02:00","required_helpers":1}}',
  'headers' => [
    'content-type' => 'application/json',
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Patch,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/time/volunteer_shift/42"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
  Content = new StringContent("{\"data\":{\"name\":\"Beispiel\",\"description\":\"Text\",\"location\":\"string\",\"start\":\"2026-10-15T09:30:00+02:00\",\"end\":\"2026-10-15T09:30:00+02:00\",\"required_helpers\":1}}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"data\":{\"name\":\"Beispiel\",\"description\":\"Text\",\"location\":\"string\",\"start\":\"2026-10-15T09:30:00+02:00\",\"end\":\"2026-10-15T09:30:00+02:00\",\"required_helpers\":1}}");
Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/time/volunteer_shift/42")
  .patch(body)
  .addHeader("x-iw-jwt-token", "<TOKEN>")
  .addHeader("content-type", "application/json")
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://eure-instanz.iw-erp.de/api/time/volunteer_shift/42"

	payload := strings.NewReader("{\"data\":{\"name\":\"Beispiel\",\"description\":\"Text\",\"location\":\"string\",\"start\":\"2026-10-15T09:30:00+02:00\",\"end\":\"2026-10-15T09:30:00+02:00\",\"required_helpers\":1}}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("x-iw-jwt-token", "<TOKEN>")
	req.Header.Add("content-type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart mit package:http (kein Controller im Package iw_erp_api)

import 'dart:convert';
import 'package:http/http.dart' as http;

final response = await http.patch(
  Uri.parse('https://eure-instanz.iw-erp.de/api/time/volunteer_shift/42'),
  headers: {'x-iw-jwt-token': '<TOKEN>', 'content-type': 'application/json'},
  body: jsonEncode({
    "data": {
      "name": "Beispiel",
      "description": "Text",
      "location": "string",
      "start": "2026-10-15T09:30:00+02:00",
      "end": "2026-10-15T09:30:00+02:00",
      "required_helpers": 1
    }
  }),
);
print(response.body);

Antwort 200 application/json

{
  "id": 42,
  "name": "Beispiel",
  "description": "Text",
  "effective_credited_minutes": 1,
  "signed_up_count": 1,
  "open_slots": 1,
  "location": "string",
  "start": "2026-10-15T09:30:00+02:00",
  "end": "2026-10-15T09:30:00+02:00",
  "required_helpers": 1
}

Helferschicht archivieren. Gutschriften der teilnehmenden Helfer bleiben erhalten.

DELETE/api/time/volunteer_shift/{id}

Pfad-Parameter

idPflichtstring

Antworten

default

Anfrage

curl --request DELETE \
  --url https://eure-instanz.iw-erp.de/api/time/volunteer_shift/42 \
  --header 'x-iw-jwt-token: <TOKEN>'

const options = {method: 'DELETE', headers: {'x-iw-jwt-token': '<TOKEN>'}};

fetch('https://eure-instanz.iw-erp.de/api/time/volunteer_shift/42', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://eure-instanz.iw-erp.de/api/time/volunteer_shift/42"

headers = {"x-iw-jwt-token": "<TOKEN>"}

response = requests.delete(url, headers=headers)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('DELETE', 'https://eure-instanz.iw-erp.de/api/time/volunteer_shift/42', [
  'headers' => [
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Delete,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/time/volunteer_shift/42"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/time/volunteer_shift/42")
  .delete(null)
  .addHeader("x-iw-jwt-token", "<TOKEN>")
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://eure-instanz.iw-erp.de/api/time/volunteer_shift/42"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("x-iw-jwt-token", "<TOKEN>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart mit dem Package iw_erp_api

import 'package:iw_erp_api/clients/volunteer_shift_controller.dart';
import 'package:iw_erp_api/logic/iw_api_state.dart';

IwApiState().host = 'eure-instanz.iw-erp.de';
IwApiState().currentJwtApiToken = '<TOKEN>';

final result = await VolunteerShiftController.delete('42');
if (result.success) {
  print(result.data);
}