List students of authenticated end-customer

GET

https://api.studiointern.de/{customer_shortname}/v2/cust/students

Last modified:2026-07-27 18:22:25

Maintainer:Not configured

Returns all students belonging to the logged-in end-customer.

End-customer session authentication (similar to OAuth, but not OAuth).

Every request to /v2/cust/* requires the tenant API key in header X-Api-Key — including login and logout.

Login (QUERY /v2/cust/login): send session_id, user_id (customer number or email), and pw.
On success the response contains data.token and data.kID. The token is returned only once
in this response — store it securely on the client; it cannot be retrieved again.

Authenticated calls (all /v2/cust/* except login and logout): send the token in header
X-Customer-Token. No additional session_id or user_id is required.

Logout (GET /v2/cust/logout/{user_id}/{session_id}): ends the session; does not use
X-Customer-Token.

The token is bound to the server-side session and is valid for 20 minutes of inactivity (same
timeout as the session). Each authenticated request resets this countdown.

Request

Authorization

API Key

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

API Key

Add parameter in header

X-Customer-Token

Example:

X-Customer-Token: ********************

Path Params

Responses

🟢200

application/json

Bodyapplication/json

🟠400

🟠401

🟠403

🟠404

🟠429

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.studiointern.de//v2/cust/students' \
--header 'X-Api-Key: <api-key>' \
--header 'X-Customer-Token: <api-key>'

Response Example

200 - Example 1

{
    "success": true,
    "code": 0,
    "locale": "de",
    "message": "string",
    "data": [
        {
            "sID": 0,
            "kID": 0,
            "vorname": "string",
            "nachname": "string",
            "geburtstag": "2019-08-24",
            "mobil": "string",
            "email": "string",
            "ist_kunde": 0
        }
    ],
    "links": {},
    "meta": {}
}

Modified at 2026-07-27 18:22:25

End-customer logout

List active course seats of authenticated end-customer