Projekte auflisten, denen ein Mitarbeiter zugeordnet ist

Liefert die paginierte Liste der Projektzuordnungen des angegebenen Mitarbeiters. Unterstützt Filterung nach project_status (string|array), project_start (YYYY-MM-DD) und project_end (YYYY-MM-DD).

Verfügbarkeit: Nur Vollversion — eine Clock-Instanz antwortet auf diesen Endpunkt mit 404.

Request

GET /api/v1/employees/{username}/projects

curl --request GET \
     --url 'https://www.zep-online.de/zepinstanz/next/api/v1/employees/{username}/projects' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {token}'

Pfad-Parameter

Name
username
Type
string
Description
Der Benutzername des Mitarbeiters

Query-Parameter

Name
perPage
Type
integer, nullable
Description
Wird auf diesem Endpunkt ignoriert — senden Sie stattdessen limit. Ein hier angegebener Wert wird durch limit ersetzt, oder durch den Standardwert, wenn limit fehlt.
Name
page
Type
integer, nullable
Description
Die zurückzugebende Ergebnisseite, beginnend bei 1.
Name
orderBy
Type
string, nullable
Description
Name des Feldes, nach dem sortiert wird.
Name
order
Type
string, nullable
Description
Sortierrichtung, aufsteigend oder absteigend.
Einer der Werte: "asc", "desc"
Name
limit
Type
integer, nullable
Description
Die Anzahl der Datensätze pro Seite, 1 bis 200. Standardwert ist 15.
Name
project_status
Type
string, nullable
Description
Beschränkt das Ergebnis auf Projekte in einem oder mehreren Status. Sowohl ein einzelner Wert als auch eine Liste wird akzeptiert.
Name
project_start_date
Type
string (date)
Description
Nur Projekte zurückgeben, deren Startdatum dieses Datum oder später ist.
Name
project_end_date
Type
string (date)
Description
Nur Projekte zurückgeben, deren Enddatum an oder vor diesem Datum liegt. Darf nicht vor project_start_date liegen.

Response

{
  "data": [
    {
      "id": 1,
      "employee_id": "string",
      "project_id": 1,
      "from": "2026-01-31T09:00:00.000000Z",
      "to": "2026-01-31T09:00:00.000000Z",
      "note": "string",
      "availability": 1,
      "internal_rate": 12.5,
      "rate_type": {
        "id": 1,
        "name": "Hourly"
      },
      "type": {
        "id": 1,
        "name": "Project member"
      },
      "priceGroup": {
        "id": 1,
        "name": "EU",
        "number": "string",
        "status": true,
        "description": {
          "de": "string",
          "en": "string",
          "fr": "string",
          "es": "string",
          "pl": "string"
        }
      }
    }
  ],
  "links": {
    "first": "string",
    "last": "string",
    "prev": "string",
    "next": "string"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "links": [
      {
        "url": "string",
        "label": "string",
        "active": true
      }
    ],
    "path": "string",
    "per_page": 1,
    "to": 1,
    "total": 1
  }
}

Response-Felder

Name
id
Type
integer
Description
Unique identifier of the assignment.
Name
employee_id
Type
string
Description
Identifier of the assigned employee.
Name
project_id
Type
integer
Description
Identifier of the project the assignment belongs to.
Name
from
Type
string (date-time), nullable
Description
Date the assignment starts.
Name
to
Type
string (date-time), nullable
Description
Date the assignment ends.
Name
note
Type
string, nullable
Description
Free-text note about the assignment.
Name
availability
Type
integer, nullable
Description
How much of the employee’s time is available for this project.
Name
internal_rate
Type
number, nullable
Description
Internal rate applied to this employee’s time on the project.
Name
rate_type
Type
object, nullable
Description
How the internal rate is applied: per hour, per day, or as a fixed amount.
Name
rate_type.id
Type
integer
Description
The stored value. Compare against this, not against name.
Name
rate_type.name
Type
string
Description
The human-readable label, delivered in the tenant’s language. Do not parse it.
Einer der Werte: "Hourly", "Täglich", "keines"
Name
type
Type
object
Description
The employee’s position on the project, e.g. lead or member.
Name
type.id
Type
integer
Description
The stored value. Compare against this, not against name.
Name
type.name
Type
string
Description
The human-readable label, delivered in the tenant’s language. Do not parse it.
Einer der Werte: "Project member", "Project manager with budget responsibility", "Projektleiter"
Name
priceGroup
Type
object (PriceGroup)
Description
Name
priceGroup.id
Type
integer
Description
Die eindeutige Kennung der Preisgruppe.
Name
priceGroup.name
Type
string
Description
Der Name der Preisgruppe, wie er bei der Zuordnung zu einem Kunden oder Projekt angezeigt wird.
Name
priceGroup.number
Type
string, nullable
Description
Die Nummer der Preisgruppe, die zur externen Referenzierung verwendet wird.
Name
priceGroup.status
Type
boolean
Description
Ob die Preisgruppe aktiv ist; die zugrunde liegende Spalte wird invertiert gespeichert, true bedeutet hier aktiv.
Name
priceGroup.description
Type
object
Description
Die Beschreibung der Preisgruppe, ausgegeben als sprachabhängige Struktur (i18n) statt als einfache Zeichenkette.

Aus der OpenAPI-Spezifikation erzeugt — Änderungen gehören in den Quellcode, nicht auf diese Seite.

GET Einzelne Mahlzeit abrufen GET Regelarbeitszeiten eines Mitarbeiters auflisten