api-docs.json

{
    "openapi": "3.0.0",
    "info": {
        "title": "Träwelling API",
        "description": "Träwelling user API description. This is an incomplete documentation with still many errors. The API is currently not yet stable. Endpoints are still being restructured. Both the URL and the request or body can be changed. Breaking changes will be announced on GitHub: https://github.com/Traewelling/traewelling/blob/develop/API_CHANGELOG.md",
        "contact": {
            "email": "support@traewelling.de"
        },
        "license": {
            "name": "Apache 2.0",
            "url": "https://www.apache.org/licenses/LICENSE-2.0.html"
        },
        "version": "1.0.0 - alpha"
    },
    "servers": [
        {
            "url": "https://traewelling.de/api/v1",
            "description": "Production Server"
        },
        {
            "url": "http://localhost:8000/api/v1",
            "description": "This instance"
        }
    ],
    "paths": {
        "/alerts": {
            "get": {
                "tags": [
                    "Notifications"
                ],
                "summary": "Get all active alerts",
                "operationId": "getActiveAlerts",
                "responses": {
                    "200": {
                        "description": "List of active alerts",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/AlertResource"
                                            }
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/auth/logout": {
            "post": {
                "tags": [
                    "Auth"
                ],
                "summary": "Logout & invalidate current bearer token",
                "operationId": "logoutUser",
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "status": {
                                            "example": "success"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "Error during revoke"
                    }
                },
                "security": [
                    {
                        "passport": []
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/auth/user": {
            "get": {
                "tags": [
                    "Auth",
                    "User"
                ],
                "summary": "Get authenticated user information",
                "description": "Get all profile information about the authenticated user",
                "operationId": "getAuthenticatedUser",
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/UserAuthResource"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Unauthorized"
                    }
                },
                "security": [
                    {
                        "passport": []
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/auth/refresh": {
            "post": {
                "tags": [
                    "Auth"
                ],
                "summary": "Refresh Bearer Token",
                "description": "This request issues a new Bearer-Token with a new expiration date while also revoking the old token.",
                "operationId": "refreshToken",
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/BearerTokenResponse"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Unauthorized"
                    }
                },
                "security": [
                    {
                        "passport": []
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/community/profile": {
            "get": {
                "tags": [
                    "Community"
                ],
                "summary": "Get your contribution profile",
                "description": "Returns contribution XP, level, and progress information for the authenticated user",
                "operationId": "getCommunityProfile",
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/CommunityProfile"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Unauthenticated"
                    }
                },
                "security": [
                    {
                        "passport": []
                    }
                ]
            }
        },
        "/community/history": {
            "get": {
                "tags": [
                    "Community"
                ],
                "summary": "Get your contribution history",
                "description": "Returns a cursor-paginated list of contribution history entries for the authenticated user",
                "operationId": "getCommunityHistory",
                "parameters": [
                    {
                        "name": "cursor",
                        "in": "query",
                        "description": "Cursor for pagination",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "description": "Number of entries per page (min 5, max 50, default 15)",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "default": 15,
                            "maximum": 50,
                            "minimum": 5
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/ContributionHistory"
                                            }
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Unauthenticated"
                    }
                },
                "security": [
                    {
                        "passport": []
                    }
                ]
            }
        },
        "/app/configuration": {
            "get": {
                "tags": [
                    "Configuration Information"
                ],
                "summary": "Get Application Configuration Information",
                "description": "Retrieves configuration information about the application, including features and supported languages.",
                "operationId": "getConfigurationInfo",
                "responses": {
                    "200": {
                        "description": "Successful retrieval of configuration information.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ConfigurationInformation"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/event/{slug}": {
            "get": {
                "tags": [
                    "Events"
                ],
                "summary": "[Auth optional] Get basic information for event",
                "description": "Returns slug, name and duration for an event",
                "operationId": "getEvent",
                "parameters": [
                    {
                        "name": "slug",
                        "in": "path",
                        "description": "slug for event",
                        "schema": {
                            "type": "string"
                        },
                        "example": "weihnachten_2022"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/EventResource"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "404": {
                        "description": "No Event found for this id"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "read-statuses"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/event/{slug}/details": {
            "get": {
                "tags": [
                    "Events"
                ],
                "summary": "[Auth optional] Get additional information for event",
                "description": "Returns overall travelled distance and duration for an event",
                "operationId": "getEventDetails",
                "parameters": [
                    {
                        "name": "slug",
                        "in": "path",
                        "description": "slug for event",
                        "schema": {
                            "type": "string"
                        },
                        "example": "weihnachten_2022"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/EventDetailsResource"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "404": {
                        "description": "No Event found for this id"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "read-statuses"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/event/{slug}/statuses": {
            "get": {
                "tags": [
                    "Events"
                ],
                "summary": "[Auth optional] Get paginated statuses for event",
                "description": "Returns all for user visible statuses for an event",
                "operationId": "getEventStatuses",
                "parameters": [
                    {
                        "name": "slug",
                        "in": "path",
                        "description": "slug for event",
                        "schema": {
                            "type": "string"
                        },
                        "example": "weihnachten_2022"
                    },
                    {
                        "name": "page",
                        "in": "query",
                        "description": "Page of pagination",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/StatusResource"
                                            }
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/PaginationMeta"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "404": {
                        "description": "No Event found for this id"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "read-statuses"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/events": {
            "get": {
                "tags": [
                    "Events"
                ],
                "summary": "[Auth optional] Show active or upcoming events for the given timestamp",
                "description": "Returns all active or upcoming events for the given timestamp. Default timestamp is now. If upcoming is set to true, all events ending after the timestamp are returned.",
                "operationId": "getEvents",
                "parameters": [
                    {
                        "name": "timestamp",
                        "in": "query",
                        "description": "The timestamp of view. Default is now.",
                        "required": false,
                        "schema": {
                            "type": "string"
                        },
                        "example": "2022-08-01T12:00:00+02:00"
                    },
                    {
                        "name": "upcoming",
                        "in": "query",
                        "description": "Show only upcoming events",
                        "required": false,
                        "schema": {
                            "type": "boolean"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/EventResource"
                                            }
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "read-statuses"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/event": {
            "post": {
                "tags": [
                    "Events"
                ],
                "summary": "Suggest a event",
                "description": "Submit a possible event for our administrators to publish",
                "operationId": "suggestEvent",
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/EventSuggestion"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "successful operation"
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "403": {
                        "description": "User not authorized"
                    }
                },
                "security": [
                    {
                        "passport": []
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/user/{id}/follow": {
            "post": {
                "tags": [
                    "User/Follow"
                ],
                "summary": "Follow a user",
                "operationId": "createFollow",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "description": "User-ID",
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1337
                    }
                ],
                "responses": {
                    "201": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/UserResource"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "409": {
                        "description": "Already following"
                    },
                    "403": {
                        "description": "User is blocked"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "write-follows"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            },
            "delete": {
                "tags": [
                    "User/Follow"
                ],
                "summary": "Unfollow a user",
                "operationId": "destroyFollow",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "description": "User-ID",
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1337
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/UserResource"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "404": {
                        "description": "User not found"
                    },
                    "409": {
                        "description": "Already following"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "write-follows"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/user/self/followers": {
            "get": {
                "tags": [
                    "User/Follow",
                    "Settings"
                ],
                "summary": "List all followers",
                "operationId": "getFollowers",
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "description": "Page number for pagination",
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/UserResource"
                                            }
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/PaginationMeta"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "409": {
                        "description": "Already following"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "read-settings-followers"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/user/self/follow-requests": {
            "get": {
                "tags": [
                    "User/Follow",
                    "Settings"
                ],
                "summary": "List all followers",
                "operationId": "getFollowRequests",
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "description": "Page number for pagination",
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/UserResource"
                                            }
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/PaginationMeta"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "passport": [
                            "read-settings-followers"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/user/self/followings": {
            "get": {
                "tags": [
                    "User/Follow",
                    "Settings"
                ],
                "summary": "List all users the current user is following",
                "operationId": "getFollowings",
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "description": "Page number for pagination",
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/UserResource"
                                            }
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/PaginationMeta"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "passport": [
                            "read-settings-followers"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/user/self/followers/{userId}": {
            "delete": {
                "tags": [
                    "User/Follow"
                ],
                "summary": "Remove a follower",
                "operationId": "removeFollower",
                "parameters": [
                    {
                        "name": "userId",
                        "in": "path",
                        "description": "User-ID",
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1337
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation"
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "403": {
                        "description": "Permission denied"
                    },
                    "404": {
                        "description": "Follow not found"
                    },
                    "500": {
                        "description": "Unknown error"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "write-followers"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/user/self/follow-requests/{userId}": {
            "put": {
                "tags": [
                    "User/Follow"
                ],
                "summary": "Accept a follow request",
                "operationId": "acceptFollowRequest",
                "parameters": [
                    {
                        "name": "userId",
                        "in": "path",
                        "description": "User-ID",
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1337
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation"
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "403": {
                        "description": "Permission denied"
                    },
                    "404": {
                        "description": "Request not found"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "write-followers"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            },
            "delete": {
                "tags": [
                    "User/Follow"
                ],
                "summary": "Reject a follow request",
                "operationId": "rejectFollowRequest",
                "parameters": [
                    {
                        "name": "userId",
                        "in": "path",
                        "description": "User-ID",
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1337
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation"
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "403": {
                        "description": "Permission denied"
                    },
                    "404": {
                        "description": "Request not found"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "write-followers"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/ics-tokens": {
            "get": {
                "tags": [
                    "ICS Tokens"
                ],
                "summary": "Get ICS tokens",
                "description": "Get all ICS tokens of the authenticated user",
                "operationId": "getIcsTokens",
                "responses": {
                    "200": {
                        "description": "success",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "required": [
                                        "data"
                                    ],
                                    "properties": {
                                        "data": {
                                            "description": "The list of ICS tokens belonging to the authenticated user",
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/IcsEntryResource"
                                            }
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "oauth2_security_example": [
                            "write:projects",
                            "read:projects"
                        ]
                    }
                ]
            },
            "post": {
                "tags": [
                    "ICS Tokens"
                ],
                "summary": "Create ICS token",
                "description": "Create a new ICS token for the authenticated user",
                "operationId": "createIcsToken",
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "required": [
                                    "name"
                                ],
                                "properties": {
                                    "name": {
                                        "description": "The name of the ICS token",
                                        "type": "string",
                                        "example": "My ICS Token"
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Created - ICS token created successfully",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "required": [
                                        "data"
                                    ],
                                    "properties": {
                                        "data": {
                                            "description": "The URL to access the ICS feed with the created token",
                                            "required": [
                                                "url"
                                            ],
                                            "properties": {
                                                "url": {
                                                    "description": "The URL to access the ICS feed with the created token",
                                                    "type": "string",
                                                    "format": "uri",
                                                    "example": "https://example.com/ics?user_id=1&token=abcd1234&limit=10000&from=2010-01-01&until=2030-12-31"
                                                }
                                            },
                                            "type": "object"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Unprocessable Entity - validation error"
                    }
                },
                "security": [
                    {
                        "oauth2_security_example": [
                            "write:projects",
                            "read:projects"
                        ]
                    }
                ]
            }
        },
        "/ics-tokens/{tokenId}": {
            "delete": {
                "tags": [
                    "ICS Tokens"
                ],
                "summary": "Revoke ICS token",
                "description": "Revoke an ICS token of the authenticated user",
                "operationId": "revokeIcsToken",
                "parameters": [
                    {
                        "name": "tokenId",
                        "in": "path",
                        "description": "The unique identifier of the ICS token to revoke",
                        "required": true,
                        "schema": {
                            "type": "integer",
                            "example": 1
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "No Content - token revoked successfully"
                    },
                    "404": {
                        "description": "Not Found - token not found or does not belong to the authenticated user"
                    }
                },
                "security": [
                    {
                        "oauth2_security_example": [
                            "write:projects",
                            "read:projects"
                        ]
                    }
                ]
            }
        },
        "/status/{id}/likes": {
            "get": {
                "tags": [
                    "Likes"
                ],
                "summary": "[Auth optional] Get likes for status",
                "description": "Returns array of users that liked the status. Can return an empty dataset when the status author or the requesting user has deactivated likes",
                "operationId": "getLikesForStatus",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "description": "Status-ID",
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1337
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/UserResource"
                                            }
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "404": {
                        "description": "No status found for this id"
                    },
                    "403": {
                        "description": "User not authorized to access this status"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "read-statuses"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/status/{id}/like": {
            "post": {
                "tags": [
                    "Likes"
                ],
                "summary": "Add like to status",
                "description": "Add like to status",
                "operationId": "addLikeToStatus",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "description": "Status-ID",
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1337
                    }
                ],
                "responses": {
                    "201": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/LikeResponse"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "403": {
                        "description": "User not authorized to access this status"
                    },
                    "404": {
                        "description": "No status found for this id"
                    },
                    "409": {
                        "description": "Status already liked by user"
                    },
                    "429": {
                        "description": "Rate limit exceeded"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "write-likes"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            },
            "delete": {
                "tags": [
                    "Likes"
                ],
                "summary": "Remove like from status",
                "description": "Removes like from status",
                "operationId": "removeLikeFromStatus",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "description": "Status-ID",
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1337
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/LikeResponse"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "404": {
                        "description": "No status found for this id"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "write-likes"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/notifications/unread/count": {
            "get": {
                "tags": [
                    "Notifications"
                ],
                "summary": "Get count of unread notifications for authenticated user",
                "description": "Returns count of unread notifications of a authenticated user",
                "operationId": "getUnreadCount",
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "integer",
                                            "example": 2
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Unauthorized"
                    }
                },
                "security": [
                    {
                        "passport": []
                    },
                    {
                        "token": []
                    },
                    {
                        "passport": [
                            "read-notifications"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/notifications": {
            "get": {
                "tags": [
                    "Notifications"
                ],
                "summary": "Get paginated notifications for authenticated user",
                "description": "Returns paginated notifications of a authenticated",
                "operationId": "listNotifications",
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Notification"
                                            }
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/PaginationMeta"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Unauthorized"
                    }
                },
                "security": [
                    {
                        "passport": []
                    },
                    {
                        "token": []
                    },
                    {
                        "passport": [
                            "read-notifications"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/notifications/read/{id}": {
            "put": {
                "tags": [
                    "Notifications"
                ],
                "summary": "Mark notification as read",
                "operationId": "markAsRead",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "description": "ID of notification",
                        "schema": {
                            "type": "string"
                        },
                        "example": "cbf6054e-9c00-4b1f-ab37-7eb18ac8419f"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Notification"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Unauthorized"
                    },
                    "404": {
                        "description": "Notification not found"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "write-notifications"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/notifications/unread/{id}": {
            "put": {
                "tags": [
                    "Notifications"
                ],
                "summary": "Mark notification as unread",
                "operationId": "markAsUnread",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "description": "ID of notification",
                        "schema": {
                            "type": "string"
                        },
                        "example": "cbf6054e-9c00-4b1f-ab37-7eb18ac8419f"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Notification"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Unauthorized"
                    },
                    "404": {
                        "description": "Notification not found"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "write-notifications"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/notifications/read/all": {
            "put": {
                "tags": [
                    "Notifications"
                ],
                "summary": "Mark all notification as read",
                "operationId": "markAllAsRead",
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "status": {
                                            "type": "string",
                                            "example": "success"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Unauthorized"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "write-notifications"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/operators": {
            "get": {
                "tags": [
                    "Checkin"
                ],
                "summary": "Get a list of all operators.",
                "operationId": "bcfcf8686980cf0fcdc751b2e13fa4f7",
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/OperatorResource"
                                            }
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Unauthenticated"
                    },
                    "403": {
                        "description": "Unauthorized"
                    },
                    "500": {
                        "description": "Internal Server Error"
                    }
                }
            }
        },
        "/static/privacy": {
            "get": {
                "tags": [
                    "Settings"
                ],
                "summary": "Get the current privacy policy",
                "description": "Get the current privacy policy",
                "operationId": "e649bec35ba50765db023e745233eda9",
                "responses": {
                    "200": {
                        "description": "Success",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "properties": {
                                                "validFrom": {
                                                    "example": "2022-01-05T16:26:14.000000Z"
                                                },
                                                "en": {
                                                    "example": "This is the english privacy policy"
                                                },
                                                "de": {
                                                    "example": "Dies ist die deutsche Datenschutzerklärung"
                                                }
                                            },
                                            "type": "object"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/settings/acceptPrivacy": {
            "post": {
                "tags": [
                    "Settings"
                ],
                "summary": "Accept the current privacy policy",
                "description": "Accept the current privacy policy",
                "operationId": "acceptPrivacyPolicy",
                "responses": {
                    "204": {
                        "description": "Success"
                    },
                    "400": {
                        "description": "Already accepted"
                    },
                    "401": {
                        "description": "Unauthorized"
                    }
                },
                "security": [
                    {
                        "passport": []
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/report": {
            "post": {
                "tags": [
                    "Report"
                ],
                "summary": "Report a Status, Event or User to the admins.",
                "operationId": "report",
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "required": [
                                    "subjectType",
                                    "subjectId",
                                    "reason"
                                ],
                                "properties": {
                                    "subjectType": {
                                        "type": "string",
                                        "example": "Status",
                                        "enum": [
                                            "Event",
                                            "Status",
                                            "User"
                                        ]
                                    },
                                    "subjectId": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "reason": {
                                        "type": "string",
                                        "example": "inappropriate",
                                        "enum": [
                                            "inappropriate",
                                            "implausible",
                                            "spam",
                                            "illegal",
                                            "other"
                                        ]
                                    },
                                    "description": {
                                        "type": "string",
                                        "example": "The status is inappropriate because...",
                                        "nullable": true
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "The report was successfully created."
                    },
                    "401": {
                        "description": "The user is not authenticated."
                    },
                    "422": {
                        "description": "The given data was invalid."
                    }
                },
                "security": [
                    {
                        "passport": []
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/security/sessions": {
            "get": {
                "tags": [
                    "Security"
                ],
                "summary": "Get active sessions",
                "description": "Get all active sessions for the authenticated user",
                "operationId": "getSessions",
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/SessionResource"
                                            }
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "passport": [
                            "scope:extra-terminate-sessions"
                        ]
                    }
                ]
            },
            "delete": {
                "tags": [
                    "Security"
                ],
                "summary": "Delete all sessions",
                "description": "Delete all active sessions for the authenticated user",
                "operationId": "deleteAllSessions",
                "responses": {
                    "204": {
                        "description": "No Content"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "scope:extra-terminate-sessions"
                        ]
                    }
                ]
            }
        },
        "/settings/profile": {
            "get": {
                "tags": [
                    "Settings"
                ],
                "summary": "Get the current user's profile settings",
                "description": "Get the current user's profile settings",
                "operationId": "getProfileSettings",
                "responses": {
                    "200": {
                        "description": "Success",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/UserProfileSettingsResource"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Unauthorized"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "read-settings"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            },
            "put": {
                "tags": [
                    "Settings"
                ],
                "summary": "Update the current user's profile settings",
                "description": "Update the current user's profile settings",
                "operationId": "updateProfileSettings",
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdateProfileInformationRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Success",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/UserProfileSettingsResource"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Unauthorized"
                    },
                    "422": {
                        "description": "Unprocessable Entity"
                    },
                    "400": {
                        "description": "Bad Request"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "write-settings"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/settings/email": {
            "put": {
                "tags": [
                    "Settings"
                ],
                "summary": "Update the current user's email address",
                "description": "Update the current user's email address",
                "operationId": "updateEmail",
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "properties": {
                                    "email": {
                                        "type": "string",
                                        "format": "email",
                                        "example": "mail@example.com"
                                    },
                                    "password": {
                                        "type": "string",
                                        "format": "password",
                                        "example": "thisisnotasecurepassword123"
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Success",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/UserProfileSettingsResource"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad Request"
                    },
                    "401": {
                        "description": "Unauthorized"
                    },
                    "422": {
                        "description": "Unprocessable Entity"
                    }
                },
                "security": [
                    {
                        "securityScheme": "passport",
                        "type": "oauth2"
                    }
                ]
            }
        },
        "/settings/email/verification": {
            "post": {
                "tags": [
                    "Settings"
                ],
                "summary": "Resend verification email",
                "description": "Resend verification email",
                "operationId": "resendVerificationEmail",
                "responses": {
                    "201": {
                        "description": "Success"
                    },
                    "429": {
                        "description": "Rate limit exceeded"
                    }
                },
                "security": [
                    {
                        "securityScheme": "passport",
                        "type": "oauth2"
                    }
                ]
            }
        },
        "/settings/profile-picture": {
            "post": {
                "tags": [
                    "Settings"
                ],
                "summary": "Upload a new profile picture for the current user",
                "description": "Upload a new profile picture for the current user",
                "operationId": "uploadProfilePicture",
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "properties": {
                                    "image": {
                                        "type": "string",
                                        "format": "base64",
                                        "example": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA..."
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Success",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "message": {
                                            "type": "string",
                                            "example": "Profile picture updated successfully."
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad Request"
                    },
                    "401": {
                        "description": "Unauthorized"
                    }
                },
                "security": [
                    {
                        "securityScheme": "passport",
                        "type": "oauth2"
                    }
                ]
            },
            "delete": {
                "tags": [
                    "Settings"
                ],
                "summary": "Delete the current user's profile picture",
                "description": "Delete the current user's profile picture",
                "operationId": "deleteProfilePicture",
                "responses": {
                    "200": {
                        "description": "Success",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "message": {
                                            "type": "string",
                                            "example": "Profile picture deleted successfully."
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad Request"
                    },
                    "401": {
                        "description": "Unauthorized"
                    }
                },
                "security": [
                    {
                        "securityScheme": "passport",
                        "type": "oauth2"
                    }
                ]
            }
        },
        "/security/social": {
            "delete": {
                "tags": [
                    "Security"
                ],
                "summary": "Delete social provider",
                "description": "Delete a connected social provider from the authenticated user",
                "operationId": "deleteSocialProvider",
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "required": [
                                    "provider"
                                ],
                                "properties": {
                                    "provider": {
                                        "description": "The social provider to delete",
                                        "type": "string",
                                        "enum": [
                                            "mastodon"
                                        ]
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "204": {
                        "description": "No Content"
                    },
                    "400": {
                        "description": "Bad Request"
                    },
                    "404": {
                        "description": "Not Found"
                    },
                    "406": {
                        "description": "Not Acceptable"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "write:projects",
                            "read:projects"
                        ]
                    }
                ]
            }
        },
        "/stations": {
            "get": {
                "tags": [
                    "Checkin"
                ],
                "summary": "Search for stations",
                "description": "UNSTABLE: Returns stations by fuzzy text, exact identifier, or within a bounding box (BBOX). **CAUTION:** Slashes in {query} must be replaced (e.g. with %20).",
                "operationId": "indexStation",
                "parameters": [
                    {
                        "name": "query",
                        "in": "query",
                        "description": "Fuzzy station search",
                        "schema": {
                            "type": "string",
                            "maxLength": 255
                        },
                        "example": "Karlsruhe Hbf"
                    },
                    {
                        "name": "identifier_provider",
                        "in": "query",
                        "description": "Identifier provider for exact lookup",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "ibnr",
                                "transitous"
                            ]
                        },
                        "example": "ibnr"
                    },
                    {
                        "name": "identifier",
                        "in": "query",
                        "description": "Station identifier for exact lookup",
                        "schema": {
                            "type": "string",
                            "maxLength": 255
                        },
                        "example": "8000191"
                    },
                    {
                        "name": "min_lat",
                        "in": "query",
                        "description": "Minimum latitude of BBOX (WGS84, -90..90)",
                        "schema": {
                            "type": "number",
                            "format": "float"
                        },
                        "example": 48.9
                    },
                    {
                        "name": "max_lat",
                        "in": "query",
                        "description": "Maximum latitude of BBOX (WGS84, -90..90)",
                        "schema": {
                            "type": "number",
                            "format": "float"
                        },
                        "example": 49.1
                    },
                    {
                        "name": "min_lon",
                        "in": "query",
                        "description": "Minimum longitude of BBOX (WGS84, -180..180)",
                        "schema": {
                            "type": "number",
                            "format": "float"
                        },
                        "example": 8.2
                    },
                    {
                        "name": "max_lon",
                        "in": "query",
                        "description": "Maximum longitude of BBOX (WGS84, -180..180)",
                        "schema": {
                            "type": "number",
                            "format": "float"
                        },
                        "example": 8.6
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "description": "Maximum number of results (capped at 100).",
                        "schema": {
                            "type": "integer",
                            "maximum": 100,
                            "minimum": 1
                        },
                        "example": 50
                    },
                    {
                        "name": "withIdentifiers",
                        "in": "query",
                        "description": "Include station identifiers in the response.",
                        "schema": {
                            "type": "boolean"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/StationResource"
                                            }
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Unauthorized"
                    },
                    "404": {
                        "description": "Station not found"
                    },
                    "503": {
                        "description": "There has been an error with our data provider"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "create-statuses"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/stations/{id}": {
            "get": {
                "tags": [
                    "Checkin"
                ],
                "summary": "Show station",
                "description": "This request returns a single station object",
                "operationId": "showStation",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "description": "station id",
                        "example": "1337"
                    },
                    {
                        "name": "withIdentifiers",
                        "in": "query",
                        "description": "Include station identifiers in the response.",
                        "schema": {
                            "type": "boolean"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/StationResource"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Unauthorized"
                    },
                    "503": {
                        "description": "There has been an error with our data provider"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "create-statuses"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/leaderboard": {
            "get": {
                "tags": [
                    "Leaderboard"
                ],
                "summary": "[Auth optional] Get array of 20 best users",
                "operationId": "getLeaderboard",
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/LeaderboardUserResource"
                                            }
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "404": {
                        "description": "No Event found for this id"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "read-statistics"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/leaderboard/distance": {
            "get": {
                "tags": [
                    "Leaderboard"
                ],
                "summary": "[Auth optional] Get leaderboard array sorted by distance",
                "operationId": "getLeaderboardByDistance",
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/LeaderboardUserResource"
                                            }
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "404": {
                        "description": "No Event found for this id"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "read-statistics"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/leaderboard/friends": {
            "get": {
                "tags": [
                    "Leaderboard"
                ],
                "summary": "Get friends-leaderboard array sorted",
                "operationId": "getLeaderboardByFriends",
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/LeaderboardUserResource"
                                            }
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "404": {
                        "description": "No Event found for this id"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "read-statistics"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/leaderboard/{month}": {
            "get": {
                "tags": [
                    "Leaderboard"
                ],
                "summary": "[Auth optional] Get leaderboard array for a specific month",
                "operationId": "getMonthlyLeaderboard",
                "parameters": [
                    {
                        "name": "month",
                        "in": "path",
                        "description": "Month for the complete leaderboard in Format `YYYY-MM`",
                        "schema": {
                            "type": "string"
                        },
                        "example": "2022-04"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/LeaderboardUserResource"
                                            }
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "404": {
                        "description": "No Event found for this id"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "read-statistics"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/statistics": {
            "get": {
                "tags": [
                    "Statistics"
                ],
                "summary": "Get personal statistics",
                "operationId": "getStatistics",
                "parameters": [
                    {
                        "name": "from",
                        "in": "query",
                        "description": "Start date for the statistics",
                        "example": "2021-01-01T00:00:00.000Z"
                    },
                    {
                        "name": "until",
                        "in": "query",
                        "description": "End date for the statistics",
                        "example": "2021-02-01T00:00:00.000Z"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "properties": {
                                                "purpose": {
                                                    "description": "The purpose of travel",
                                                    "type": "array",
                                                    "items": {
                                                        "properties": {
                                                            "name": {
                                                                "$ref": "#/components/schemas/Business"
                                                            },
                                                            "count": {
                                                                "type": "integer",
                                                                "example": 11
                                                            },
                                                            "duration": {
                                                                "description": "Duration in minutes",
                                                                "type": "integer",
                                                                "example": 425
                                                            }
                                                        },
                                                        "type": "object"
                                                    }
                                                },
                                                "categories": {
                                                    "description": "The categories of the travel",
                                                    "type": "array",
                                                    "items": {
                                                        "properties": {
                                                            "name": {
                                                                "$ref": "#/components/schemas/HafasTravelType"
                                                            },
                                                            "count": {
                                                                "type": "integer",
                                                                "example": 11
                                                            },
                                                            "duration": {
                                                                "description": "Duration in minutes",
                                                                "type": "integer",
                                                                "example": 425
                                                            }
                                                        },
                                                        "type": "object"
                                                    }
                                                },
                                                "operators": {
                                                    "description": "The operators of the means of transport",
                                                    "type": "array",
                                                    "items": {
                                                        "properties": {
                                                            "name": {
                                                                "example": "Gertruds Verkehrsgesellschaft mbH"
                                                            },
                                                            "count": {
                                                                "type": "integer",
                                                                "example": 10
                                                            },
                                                            "duration": {
                                                                "description": "Duration in minutes",
                                                                "type": "integer",
                                                                "example": 424
                                                            }
                                                        },
                                                        "type": "object"
                                                    }
                                                },
                                                "time": {
                                                    "description": "Shows the daily travel volume",
                                                    "type": "array",
                                                    "items": {
                                                        "properties": {
                                                            "date": {
                                                                "type": "string",
                                                                "example": "2021-01-01T00:00:00.000Z"
                                                            },
                                                            "count": {
                                                                "type": "integer",
                                                                "example": 10
                                                            },
                                                            "duration": {
                                                                "description": "Duration in minutes",
                                                                "type": "integer",
                                                                "example": 424
                                                            }
                                                        },
                                                        "type": "object"
                                                    }
                                                }
                                            },
                                            "type": "object"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "401": {
                        "description": "Unauthorized"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "read-statistics"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/statistics/daily/{date}": {
            "get": {
                "tags": [
                    "Statistics"
                ],
                "summary": "Get statistics and statuses of one day",
                "description": "Returns all statuses and statistics for the requested day",
                "operationId": "getDailyStatistics",
                "parameters": [
                    {
                        "name": "date",
                        "in": "path",
                        "description": "Date for the statistics in Format `YYYY-MM-DD`",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "2024-04-09"
                    },
                    {
                        "name": "timezone",
                        "in": "query",
                        "description": "Timezone for the date. If not set, the user's timezone will be used.",
                        "schema": {
                            "type": "string"
                        },
                        "example": "Europe/Berlin"
                    },
                    {
                        "name": "withPolylines",
                        "in": "query",
                        "description": "If this parameter is set, the polylines will be returned as well. Otherwise attribute is null.",
                        "schema": {
                            "type": "boolean"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "properties": {
                                                "statuses": {
                                                    "type": "array",
                                                    "items": {
                                                        "$ref": "#/components/schemas/StatusResource"
                                                    }
                                                },
                                                "polylines": {
                                                    "type": "array",
                                                    "items": {
                                                        "$ref": "#/components/schemas/FeatureCollection"
                                                    }
                                                },
                                                "totalDistance": {
                                                    "type": "integer",
                                                    "example": "74026"
                                                },
                                                "totalDuration": {
                                                    "type": "integer",
                                                    "example": "4711"
                                                },
                                                "totalPoints": {
                                                    "type": "integer",
                                                    "example": "42"
                                                },
                                                "prevDate": {
                                                    "description": "Nearest earlier date with check-ins (YYYY-MM-DD), or null.",
                                                    "type": "string",
                                                    "example": "2024-04-07",
                                                    "nullable": true
                                                },
                                                "nextDate": {
                                                    "description": "Nearest later date with check-ins (YYYY-MM-DD), or null.",
                                                    "type": "string",
                                                    "example": "2024-04-11",
                                                    "nullable": true
                                                }
                                            },
                                            "type": "object"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "401": {
                        "description": "Unauthorized"
                    },
                    "403": {
                        "description": "User not authorized to access this"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "read-statistics"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/statistics/global": {
            "get": {
                "tags": [
                    "Statistics"
                ],
                "summary": "Get global statistics of the last 4 weeks",
                "operationId": "getGlobalStatistics",
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/StatisticsGlobalData"
                                        },
                                        "meta": {
                                            "properties": {
                                                "from": {
                                                    "example": "2021-01-01T00:00:00.000000Z"
                                                },
                                                "until": {
                                                    "example": "2021-02-01T00:00:00.000000Z"
                                                }
                                            },
                                            "type": "object"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "passport": [
                            "read-statistics"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/dashboard": {
            "get": {
                "tags": [
                    "Dashboard"
                ],
                "summary": "Get paginated statuses of personal dashboard",
                "description": "Returns paginated statuses of personal dashboard",
                "operationId": "getDashboard",
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "description": "Page of pagination",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/StatusResource"
                                            }
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/PaginationMeta"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "401": {
                        "description": "Not logged in"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "read-statuses"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/dashboard/future": {
            "get": {
                "tags": [
                    "Dashboard"
                ],
                "summary": "Get paginated future statuses of current user",
                "description": "Returns paginated statuses of the authenticated user, that are more than 20 minutes in the future",
                "operationId": "getFutureDashboard",
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "description": "Page of pagination",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/StatusResource"
                                            }
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/PaginationMeta"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "401": {
                        "description": "Not logged in"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "read-statuses"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/statuses": {
            "get": {
                "tags": [
                    "Status"
                ],
                "summary": "[Auth optional] Get active statuses",
                "description": "Returns all currently active statuses that are visible to the (un)authenticated user",
                "operationId": "getActiveStatuses",
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/StatusResource"
                                            }
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "read-statuses"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/positions": {
            "get": {
                "tags": [
                    "Status"
                ],
                "summary": "[Auth optional] get live positions for active statuses",
                "description": "Returns an array of live position objects for active statuses",
                "operationId": "getLivePositionsForActiveStatuses",
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/LivePointDto"
                                            }
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "User not authorized to access this status"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "read-statuses"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/positions/{ids}": {
            "get": {
                "tags": [
                    "Status"
                ],
                "summary": "[Auth optional] get live positions for given statuses",
                "description": "Returns an array of live position objects for given status IDs",
                "operationId": "getLivePositionsForStatuses",
                "parameters": [
                    {
                        "name": "ids",
                        "in": "path",
                        "description": "Status-IDs separated by comma",
                        "schema": {
                            "type": "string"
                        },
                        "example": "1337,1338"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/LivePointDto"
                                            }
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "User not authorized to access this status"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "read-statuses"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/status": {
            "get": {
                "tags": [
                    "Status"
                ],
                "summary": "[Auth optional] List and filter statuses",
                "description": "Returns paginated list of statuses, filtered by given parameters",
                "operationId": "listStatuses",
                "parameters": [
                    {
                        "name": "body",
                        "in": "query",
                        "description": "Filter by text in status body",
                        "schema": {
                            "type": "string"
                        },
                        "example": "Having a great trip!"
                    },
                    {
                        "name": "user_id",
                        "in": "query",
                        "description": "Filter by user ID",
                        "schema": {
                            "type": "integer"
                        },
                        "example": 42
                    },
                    {
                        "name": "origin_text",
                        "in": "query",
                        "description": "Filter by origin station name",
                        "schema": {
                            "type": "string"
                        },
                        "example": "Central Station"
                    },
                    {
                        "name": "origin_id",
                        "in": "query",
                        "description": "Filter by origin station ID",
                        "schema": {
                            "type": "integer"
                        },
                        "example": 5
                    },
                    {
                        "name": "destination_text",
                        "in": "query",
                        "description": "Filter by destination station name",
                        "schema": {
                            "type": "string"
                        },
                        "example": "Main Square"
                    },
                    {
                        "name": "destination_id",
                        "in": "query",
                        "description": "Filter by destination station ID",
                        "schema": {
                            "type": "integer"
                        },
                        "example": 10
                    }
                ],
                "responses": {
                    "200": {
                        "description": "list of matching statuses",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/StatusResource"
                                            }
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/status/{id}": {
            "get": {
                "tags": [
                    "Status"
                ],
                "summary": "[Auth optional] Get single statuses",
                "description": "Returns a single status Object, if user is authorized to see it",
                "operationId": "getSingleStatus",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "description": "Status-ID",
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1337
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/StatusResource"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "404": {
                        "description": "No status found for this id"
                    },
                    "403": {
                        "description": "User not authorized to access this status"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "read-statuses"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            },
            "put": {
                "tags": [
                    "Status"
                ],
                "summary": "Update a status",
                "description": "Updates a single status Object, if user is authorized to",
                "operationId": "updateSingleStatus",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "description": "Status-ID",
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1337
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/StatusUpdateBody"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/StatusResource"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "404": {
                        "description": "No status found for this id"
                    },
                    "403": {
                        "description": "User not authorized to manipulate this status"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "write-statuses"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            },
            "delete": {
                "tags": [
                    "Status"
                ],
                "summary": "Destroy a status",
                "description": "Deletes a single status Object, if user is authorized to",
                "operationId": "destroySingleStatus",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "description": "Status-ID",
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1337
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Status deleted."
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "404": {
                        "description": "No status found for this id"
                    },
                    "403": {
                        "description": "User not authorized to manipulate this status"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "write-statuses"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/polyline/{ids}": {
            "get": {
                "tags": [
                    "Status"
                ],
                "summary": "[Auth optional] Get GeoJSON for statuses",
                "description": "Returns GeoJSON for all requested status IDs",
                "operationId": "getPolylines",
                "parameters": [
                    {
                        "name": "ids",
                        "in": "path",
                        "description": "comma seperated status IDs",
                        "schema": {
                            "type": "string"
                        },
                        "example": "1337,1338"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "properties": {
                                                "type": {
                                                    "example": "FeatureCollection"
                                                },
                                                "features": {
                                                    "type": "array",
                                                    "items": {
                                                        "$ref": "#/components/schemas/Polyline"
                                                    }
                                                }
                                            },
                                            "type": "object"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "404": {
                        "description": "No status found for this id"
                    },
                    "403": {
                        "description": "User not authorized to access this status"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "read-statuses"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/stopovers/{ids}": {
            "get": {
                "tags": [
                    "Status"
                ],
                "summary": "[Auth optional] Get stopovers for statuses",
                "description": "Returns all underway-stops for stations",
                "operationId": "getStopOvers",
                "parameters": [
                    {
                        "name": "ids",
                        "in": "path",
                        "description": "comma seperated trip IDs",
                        "schema": {
                            "type": "string"
                        },
                        "example": "1,2"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "properties": {
                                                "1": {
                                                    "description": "Array of stopovers. Key describes trip id",
                                                    "type": "array",
                                                    "items": {
                                                        "$ref": "#/components/schemas/StopoverResource"
                                                    }
                                                }
                                            },
                                            "type": "object"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "404": {
                        "description": "No status found for this id"
                    },
                    "403": {
                        "description": "User not authorized to access this status"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "read-statuses"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/user/statuses/active": {
            "get": {
                "tags": [
                    "Auth"
                ],
                "summary": "User state",
                "description": "This request returns whether the currently logged-in user has an active check-in or not.",
                "operationId": "userState",
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/StatusResource"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Unauthorized"
                    },
                    "204": {
                        "description": "No active checkin"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "read-statuses"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/status/{statusId}/tags": {
            "get": {
                "tags": [
                    "Status"
                ],
                "summary": "Show all tags for a status which are visible for the current user",
                "description": "Returns a collection of all visible tags for the given status, if user is authorized",
                "operationId": "getTagsForStatus",
                "parameters": [
                    {
                        "name": "statusId",
                        "in": "path",
                        "description": "Status-ID",
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1337
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/StatusTagResource"
                                            }
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "401": {
                        "description": "Unauthorized"
                    },
                    "404": {
                        "description": "No status found for this id"
                    },
                    "403": {
                        "description": "User not authorized to access this status"
                    }
                },
                "security": [
                    {
                        "passport": []
                    },
                    {
                        "token": []
                    }
                ]
            },
            "post": {
                "tags": [
                    "Status"
                ],
                "summary": "Create a StatusTag",
                "description": "Creates a single StatusTag Object, if user is authorized to. Triggers a `checkin_update` webhook event. <br><br>The key of a tag is free text. You can choose it as you need it. However, <b>please use a namespace for tags</b> (<i>namespace:xxx</i>) that only affect your own application.<br><br>For tags related to standard actions we recommend the following tags in the trwl namespace:<br> <ul> <li>trwl:seat (i.e. 61)</li> <li>trwl:wagon (i.e. 25)</li> <li>trwl:ticket (i.e. BahnCard 100 first))</li> <li>trwl:price (420,69 €)</li> <li>trwl:travel_class (i.e. 1, 2, business, economy, ...)</li> <li>trwl:locomotive_class (BR424, BR450)</li> <li>trwl:journey_number (i.e. 1234. Used as a work-around for missing journey numbers)</li> <li>trwl:wagon_class (i.e. Bpmz)</li> <li>trwl:role (i.e. Tf, Zf, Gf, Lokführer, conducteur de train, ...)</li> <li>trwl:vehicle_number (i.e. 425 001, Tz9001, 123, ...)</li> <li>trwl:passenger_rights (i.e. yes / no / ID of claim)</li> <li>trwl:social_status – social availability indicator. Allowed values: <code>open</code> (open to chatting), <code>open_find_me</code> (open, but staying at seat), <code>open_lets_hang</code> (open and willing to move around), <code>do_not_disturb</code> (prefer not to be disturbed).</li> </ul>",
                "operationId": "createSingleStatusTag",
                "parameters": [
                    {
                        "name": "statusId",
                        "in": "path",
                        "description": "Status-ID",
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1337
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/StatusTagResource"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/StatusTagResource"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "401": {
                        "description": "Unauthorized"
                    },
                    "404": {
                        "description": "No status found for this id"
                    },
                    "403": {
                        "description": "User not authorized to manipulate this status"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "write-statuses"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/statuses/{statusIds}/tags": {
            "get": {
                "tags": [
                    "Status"
                ],
                "summary": "Show all tags for multiple statuses which are visible for the current user",
                "description": "Returns a collection of all visible tags for the given statuses, if user is authorized",
                "operationId": "getTagsForMultipleStatuses",
                "parameters": [
                    {
                        "name": "statusIds",
                        "in": "path",
                        "description": "Status-ID",
                        "schema": {
                            "type": "string"
                        },
                        "example": "1337,4711"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "properties": {
                                                "1337": {
                                                    "type": "array",
                                                    "items": {
                                                        "$ref": "#/components/schemas/StatusTagResource"
                                                    }
                                                },
                                                "4711": {
                                                    "type": "array",
                                                    "items": {
                                                        "$ref": "#/components/schemas/StatusTagResource"
                                                    }
                                                }
                                            },
                                            "type": "object"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "401": {
                        "description": "Unauthorized"
                    },
                    "403": {
                        "description": "User not authorized to access this"
                    }
                },
                "security": [
                    {
                        "passport": []
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/status/{statusId}/tags/{tagKey}": {
            "put": {
                "tags": [
                    "Status"
                ],
                "summary": "Update a StatusTag",
                "description": "Updates a single StatusTag Object, if user is authorized to. Triggers a `checkin_update` webhook event.",
                "operationId": "updateSingleStatusTag",
                "parameters": [
                    {
                        "name": "statusId",
                        "in": "path",
                        "description": "Status-ID",
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1337
                    },
                    {
                        "name": "tagKey",
                        "in": "path",
                        "description": "Key of StatusTag",
                        "schema": {
                            "type": "string"
                        },
                        "example": "seat"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/StatusTagResource"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/StatusTagResource"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "401": {
                        "description": "Unauthorized"
                    },
                    "404": {
                        "description": "No status found for this id"
                    },
                    "403": {
                        "description": "User not authorized to manipulate this status"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "write-statuses"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            },
            "delete": {
                "tags": [
                    "Status"
                ],
                "summary": "Destroy a StatusTag",
                "description": "Deletes a single StatusTag Object, if user is authorized to. Triggers a `checkin_update` webhook event.",
                "operationId": "destroySingleStatusTag",
                "parameters": [
                    {
                        "name": "statusId",
                        "in": "path",
                        "description": "Status-ID",
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1337
                    },
                    {
                        "name": "tagKey",
                        "in": "path",
                        "description": "Key of StatusTag",
                        "schema": {
                            "type": "string"
                        },
                        "example": "trwl:seat"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "status": {
                                            "type": "string",
                                            "example": "success"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "401": {
                        "description": "Unauthorized"
                    },
                    "404": {
                        "description": "No status found for this id and statusId"
                    },
                    "403": {
                        "description": "User not authorized to manipulate this status"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "write-statuses"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/security/tokens": {
            "get": {
                "tags": [
                    "Security"
                ],
                "summary": "Get active API tokens",
                "description": "Get all active API tokens for the authenticated user",
                "operationId": "getTokens",
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "required": [
                                        "data"
                                    ],
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/TokenResource"
                                            }
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "passport": [
                            "scope:extra-terminate-sessions"
                        ]
                    }
                ]
            },
            "post": {
                "tags": [
                    "Security"
                ],
                "summary": "Create API token",
                "description": "Create a new API token for the authenticated user",
                "operationId": "createToken",
                "responses": {
                    "201": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "required": [
                                        "data"
                                    ],
                                    "properties": {
                                        "data": {
                                            "required": [
                                                "token"
                                            ],
                                            "properties": {
                                                "token": {
                                                    "description": "The newly created API token",
                                                    "type": "string",
                                                    "example": "abc123def456"
                                                }
                                            },
                                            "type": "object"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "passport": [
                            "scope:extra-terminate-sessions"
                        ]
                    }
                ]
            },
            "delete": {
                "tags": [
                    "Security"
                ],
                "summary": "Revoke all API tokens",
                "description": "Revoke all API tokens for the authenticated user",
                "operationId": "revokeAllTokens",
                "responses": {
                    "204": {
                        "description": "No Content"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "scope:extra-terminate-sessions"
                        ]
                    }
                ]
            }
        },
        "/security/tokens/{tokenId}": {
            "delete": {
                "tags": [
                    "Security"
                ],
                "summary": "Revoke API token",
                "description": "Revoke a specific API token for the authenticated user",
                "operationId": "revokeToken",
                "parameters": [
                    {
                        "name": "tokenId",
                        "in": "path",
                        "description": "The ID of the token to revoke",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "No Content"
                    },
                    "403": {
                        "description": "Forbidden"
                    },
                    "404": {
                        "description": "Not Found"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "scope:extra-terminate-sessions"
                        ]
                    }
                ]
            }
        },
        "/station/{id}/departures": {
            "get": {
                "tags": [
                    "Checkin"
                ],
                "summary": "Get departures from a station",
                "description": "Get departures from a station.",
                "operationId": "getDepartures",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "description": "Träwelling-ID of the station (you can look this up with [trainStationAutocomplete](#/Checkin/trainStationAutocomplete))",
                        "required": true
                    },
                    {
                        "name": "when",
                        "in": "query",
                        "description": "When to get the departures (default: now). If you omit the timezone, the datetime is interpreted as localtime. This is especially helpful when träwelling abroad.",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "example": "2020-01-01T12:00:00.000Z"
                        }
                    },
                    {
                        "name": "travelType",
                        "in": "query",
                        "description": "Means of transport (default: all)",
                        "required": false,
                        "schema": {
                            "$ref": "#/components/schemas/TravelType"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/DepartureResource"
                                            }
                                        },
                                        "meta": {
                                            "properties": {
                                                "station": {
                                                    "$ref": "#/components/schemas/Station"
                                                },
                                                "times": {
                                                    "properties": {
                                                        "now": {
                                                            "type": "string",
                                                            "format": "date-time",
                                                            "example": "2020-01-01T12:00:00.000Z"
                                                        },
                                                        "prev": {
                                                            "type": "string",
                                                            "format": "date-time",
                                                            "example": "2020-01-01T11:45:00.000Z"
                                                        },
                                                        "next": {
                                                            "type": "string",
                                                            "format": "date-time",
                                                            "example": "2020-01-01T12:15:00.000Z"
                                                        }
                                                    },
                                                    "type": "object"
                                                },
                                                "removedLicenses": {
                                                    "description": "List of licenses that were filtered out",
                                                    "type": "array",
                                                    "items": {
                                                        "oneOf": [
                                                            {
                                                                "type": "string",
                                                                "example": "FR: fr_horaires-sncf.gtfs"
                                                            },
                                                            {
                                                                "$ref": "#/components/schemas/LicenseDto"
                                                            }
                                                        ]
                                                    }
                                                },
                                                "removedCount": {
                                                    "description": "Number of removed entries due to license filtering",
                                                    "type": "integer",
                                                    "example": 2
                                                }
                                            },
                                            "type": "object"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Unauthorized"
                    },
                    "404": {
                        "description": "Station not found"
                    },
                    "422": {
                        "description": "Invalid input"
                    },
                    "502": {
                        "description": "Error with our data provider"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "create-statuses"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/trains/trip": {
            "get": {
                "tags": [
                    "Checkin"
                ],
                "summary": "Get the stopovers and trip information for a given train",
                "operationId": "getTrainTrip",
                "parameters": [
                    {
                        "name": "hafasTripId",
                        "in": "query",
                        "description": "HAFAS trip ID (fetched from departures)",
                        "required": true,
                        "example": "1|323306|1|80|17072022"
                    },
                    {
                        "name": "lineName",
                        "in": "query",
                        "description": "line name for that train",
                        "required": true,
                        "example": "S 4"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/TripResource"
                                            }
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "401": {
                        "description": "Unauthorized"
                    },
                    "404": {
                        "description": "No station found"
                    },
                    "503": {
                        "description": "There has been an error with our data provider"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "create-statuses"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/trains/station/nearby": {
            "get": {
                "tags": [
                    "Checkin"
                ],
                "summary": "Location based search for stations",
                "description": "Returns the nearest station to the given coordinates",
                "operationId": "trainStationsNearby",
                "parameters": [
                    {
                        "name": "latitude",
                        "in": "query",
                        "description": "latitude",
                        "required": true,
                        "example": 48.991
                    },
                    {
                        "name": "longitude",
                        "in": "query",
                        "description": "longitude",
                        "required": true,
                        "example": 8.4005
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Station"
                                            }
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "401": {
                        "description": "Unauthorized"
                    },
                    "404": {
                        "description": "No station found"
                    },
                    "503": {
                        "description": "There has been an error with our data provider"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "create-statuses"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/trains/checkin": {
            "post": {
                "tags": [
                    "Checkin"
                ],
                "summary": "Check in to a trip.",
                "operationId": "createCheckin",
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CheckinRequestBody"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CheckinSuccessResource"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "401": {
                        "description": "Unauthorized"
                    },
                    "403": {
                        "description": "Forbidden — one or more users in `with` cannot be checked in",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "message": {
                                            "type": "string",
                                            "example": "You are not allowed to check in the following users: 1"
                                        },
                                        "meta": {
                                            "properties": {
                                                "invalidUsers": {
                                                    "type": "array",
                                                    "items": {
                                                        "type": "integer",
                                                        "example": 1
                                                    }
                                                }
                                            },
                                            "type": "object"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "Checkin collision"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "create-statuses"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/station/{id}/home": {
            "put": {
                "tags": [
                    "Checkin"
                ],
                "summary": "Set a station as home station",
                "operationId": "setHomeStation",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "description": "Träwelling-ID of the station",
                        "required": true,
                        "example": 1234
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Station"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "401": {
                        "description": "Unauthorized"
                    },
                    "404": {
                        "description": "Station not found"
                    },
                    "500": {
                        "description": "Unknown error"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "create-statuses"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/trains/station/autocomplete/{query}": {
            "get": {
                "tags": [
                    "Checkin"
                ],
                "summary": "Autocomplete for stations",
                "description": "This request returns an array of max. 10 station objects matching the query. **CAUTION:** All slashes (as well as encoded to %2F) in {query} need to be replaced, preferrably by a space (%20)",
                "operationId": "trainStationAutocomplete",
                "parameters": [
                    {
                        "name": "query",
                        "in": "path",
                        "description": "station query",
                        "example": "Karls"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/StationResource"
                                            }
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Unauthorized"
                    },
                    "503": {
                        "description": "There has been an error with our data provider"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "create-statuses"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/trains/station/history": {
            "get": {
                "tags": [
                    "Checkin"
                ],
                "summary": "History for stations",
                "description": "This request returns an array of max. 10 most recent station objects that the user has arrived at.",
                "operationId": "trainStationHistory",
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Station"
                                            }
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Unauthorized"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "create-statuses"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/trips/{id}/statuses": {
            "get": {
                "tags": [
                    "Trips"
                ],
                "summary": "[Auth optional] Get statuses for a trip",
                "description": "Returns all statuses visible to the (un)authenticated user for a given trip",
                "operationId": "getTripStatuses",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "description": "Internal trip ID (available as checkin.trip in the status response)",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "example": 4711
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/StatusResource"
                                            }
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Trip not found"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "read-statuses"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/user/{user}/trusted": {
            "get": {
                "tags": [
                    "User"
                ],
                "summary": "Get all trusted users for a user",
                "description": "Get all trusted users for the current user or a specific user (admin only).",
                "operationId": "trustedUserIndex",
                "parameters": [
                    {
                        "name": "user",
                        "in": "path",
                        "description": "ID of the user (or string 'self' for current user)",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "List of trusted users",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/TrustedUserResource"
                                            }
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Unauthorized"
                    },
                    "403": {
                        "description": "Forbidden"
                    },
                    "404": {
                        "description": "User not found"
                    },
                    "500": {
                        "description": "Internal Server Error"
                    }
                }
            },
            "post": {
                "tags": [
                    "User"
                ],
                "summary": "Add a user to the trusted users for a user",
                "description": "Add a user to the trusted users for the current user or a specific user (admin only).",
                "operationId": "trustedUserStore",
                "parameters": [
                    {
                        "name": "user",
                        "in": "path",
                        "description": "ID of the user (or string 'self' for current user) who want's to trust.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "required": [
                                    "user_id"
                                ],
                                "properties": {
                                    "userId": {
                                        "type": "integer",
                                        "example": "1"
                                    },
                                    "expiresAt": {
                                        "type": "string",
                                        "format": "date-time",
                                        "example": "2024-07-28T00:00:00Z",
                                        "nullable": true
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "User added to trusted users"
                    },
                    "400": {
                        "description": "Bad Request"
                    },
                    "401": {
                        "description": "Unauthorized"
                    },
                    "403": {
                        "description": "Forbidden"
                    },
                    "404": {
                        "description": "User not found"
                    },
                    "500": {
                        "description": "Internal Server Error"
                    }
                }
            }
        },
        "/user/self/trusted-by": {
            "get": {
                "tags": [
                    "User"
                ],
                "summary": "Get all users who trust the current user",
                "operationId": "trustedByUserIndex",
                "responses": {
                    "200": {
                        "description": "List of users who trust the current user",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/TrustedUserResource"
                                            }
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Unauthorized"
                    },
                    "500": {
                        "description": "Internal Server Error"
                    }
                }
            }
        },
        "/user/{user}/trusted/{trusted}": {
            "delete": {
                "tags": [
                    "User"
                ],
                "summary": "Remove a user from the trusted users for a user",
                "description": "Remove a user from the trusted users for the current user or a specific user (admin only).",
                "operationId": "trustedUserDestroy",
                "parameters": [
                    {
                        "name": "user",
                        "in": "path",
                        "description": "ID of the user (or string 'self' for current user)",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "trusted",
                        "in": "path",
                        "description": "ID of the trusted user",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "User removed from trusted users"
                    },
                    "401": {
                        "description": "Unauthorized"
                    },
                    "403": {
                        "description": "Forbidden"
                    },
                    "404": {
                        "description": "User not found"
                    },
                    "500": {
                        "description": "Internal Server Error"
                    }
                }
            }
        },
        "/settings/account": {
            "delete": {
                "tags": [
                    "Settings"
                ],
                "summary": "Delete User Account",
                "description": "Deletes the Account for the user and all posts created by it",
                "operationId": "deleteUserAccount",
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "properties": {
                                    "confirmation": {
                                        "title": "confirmation",
                                        "description": "Username of the to be deleted account (needs to match the currently logged in user)",
                                        "example": "Gertrud123"
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "successful operation"
                    },
                    "409": {
                        "description": "Conflict. This should not happen but it tries to prevent a 500."
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "401": {
                        "description": "Not logged in"
                    },
                    "403": {
                        "description": "User not authorized to do this action"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "extra-delete"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/user/{username}/statuses": {
            "get": {
                "tags": [
                    "User",
                    "Status"
                ],
                "summary": "[Auth optional] Get paginated statuses for single user",
                "description": "Returns paginated statuses of a single user specified by the username",
                "operationId": "getStatusesForUser",
                "parameters": [
                    {
                        "name": "username",
                        "in": "path",
                        "description": "username",
                        "example": "Gertrud123"
                    },
                    {
                        "name": "page",
                        "in": "query",
                        "description": "Page of pagination",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/StatusResource"
                                            }
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/PaginationMeta"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "403": {
                        "description": "Forbidden, User is blocked"
                    }
                },
                "security": [
                    {
                        "passport": []
                    },
                    {
                        "token": []
                    },
                    {
                        "passport": [
                            "read-statuses"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/user/{username}": {
            "get": {
                "tags": [
                    "User"
                ],
                "summary": "[Auth optional] Get information for single user",
                "description": "Returns general information, metadata and statistics for a user",
                "operationId": "showUser",
                "parameters": [
                    {
                        "name": "username",
                        "in": "path",
                        "description": "username",
                        "example": "Gertrud123"
                    },
                    {
                        "name": "page",
                        "in": "query",
                        "description": "Page of pagination",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/UserResource"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "403": {
                        "description": "Forbidden, User is blocked",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "required": [
                                        "message"
                                    ],
                                    "properties": {
                                        "message": {
                                            "type": "string",
                                            "example": "User not accessible."
                                        },
                                        "reason": {
                                            "$ref": "#/components/schemas/ViewUserForbiddenReason"
                                        },
                                        "user": {
                                            "$ref": "#/components/schemas/UserResource"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "User not found"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "read-statuses"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/user/{id}/block": {
            "post": {
                "tags": [
                    "User/Hide and Block"
                ],
                "summary": "Block a user",
                "description": "Block a specific user. That user will not be able to see your statuses or profile information, and cannot send you follow requests. Public statuses are still visible through the incognito mode.",
                "operationId": "createBlock",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "description": "User-ID",
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1337
                    }
                ],
                "responses": {
                    "201": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/UserResource"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "401": {
                        "description": "Not logged in"
                    },
                    "403": {
                        "description": "User not authorized"
                    },
                    "404": {
                        "description": "User not found"
                    },
                    "409": {
                        "description": "User is already blocked"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "write-block"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            },
            "delete": {
                "tags": [
                    "User/Hide and Block"
                ],
                "summary": "Unmute a user",
                "description": "Unblock a specific user. They are now able to see your statuses and profile information again, and send you follow requests.",
                "operationId": "destroyBlock",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "description": "User-ID",
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1337
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/UserResource"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "401": {
                        "description": "Not logged in"
                    },
                    "403": {
                        "description": "User not authorized"
                    },
                    "404": {
                        "description": "User not found"
                    },
                    "409": {
                        "description": "User is not blocked"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "write-block"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/user/{id}/mute": {
            "post": {
                "tags": [
                    "User/Hide and Block"
                ],
                "summary": "Mute a user",
                "description": "Mute a specific user. That way they will not be shown on your dashboard and in the active journeys tab",
                "operationId": "createMute",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "description": "User-ID",
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1337
                    }
                ],
                "responses": {
                    "201": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/UserResource"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "401": {
                        "description": "Not logged in"
                    },
                    "409": {
                        "description": "User is already muted"
                    },
                    "403": {
                        "description": "User not authorized"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "write-block"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            },
            "delete": {
                "tags": [
                    "User/Hide and Block"
                ],
                "summary": "Unmute a user",
                "description": "Unmute a specific user. That way they will be shown on your dashboard and in the active journeys tab again",
                "operationId": "destroyMute",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "description": "User-ID",
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1337
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/UserResource"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "401": {
                        "description": "Not logged in"
                    },
                    "409": {
                        "description": "User is not muted"
                    },
                    "403": {
                        "description": "User not authorized"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "write-block"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/user/search/{query}": {
            "get": {
                "tags": [
                    "User"
                ],
                "summary": "Get paginated search results for combined search on username and (display)name",
                "description": "Returns paginated search results for a user based on the given query.",
                "operationId": "searchUsers",
                "parameters": [
                    {
                        "name": "query",
                        "in": "path",
                        "description": "If this is given, the search will be performed on the username and (display)name (or-search)",
                        "example": "Gertrud123"
                    },
                    {
                        "name": "page",
                        "in": "query",
                        "description": "Page of pagination",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/UserResource"
                                            }
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/PaginationMeta"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "read-search"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/user/search": {
            "get": {
                "tags": [
                    "User"
                ],
                "summary": "Get paginated search results for users by either username or (display)name",
                "description": "Returns paginated search results for users based on the given parameters.",
                "operationId": "searchUsersByParameters",
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "description": "Page of pagination",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "username",
                        "in": "query",
                        "description": "Search for parts username",
                        "required": false
                    },
                    {
                        "name": "name",
                        "in": "query",
                        "description": "Search for parts of users (display)name",
                        "required": false
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/UserResource"
                                            }
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/PaginationMeta"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "read-search"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/webhooks": {
            "get": {
                "tags": [
                    "Webhooks"
                ],
                "summary": "Get webhooks for current user and current application.",
                "description": "Returns all webhooks which are created for the current user and which the current authorized applicaton has access to.",
                "operationId": "getWebhooks",
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "required": [
                                        "data"
                                    ],
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/WebhookResource"
                                            }
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Unauthorized"
                    }
                },
                "security": [
                    {
                        "passport": []
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/webhooks/{id}": {
            "get": {
                "tags": [
                    "Webhooks"
                ],
                "summary": "Get single webhook",
                "description": "Returns a single webhook Object, if user and application is authorized to see it",
                "operationId": "getSingleWebhook",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "description": "Webhook-ID",
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1337
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "required": [
                                        "data"
                                    ],
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/WebhookResource"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "404": {
                        "description": "No webhook found or unauthorized for this id"
                    }
                },
                "security": [
                    {
                        "passport": []
                    },
                    {
                        "token": []
                    }
                ]
            },
            "delete": {
                "tags": [
                    "Webhooks"
                ],
                "summary": "Delete a webhook if the user and application is authorized to do",
                "description": "",
                "operationId": "deleteWebhook",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "description": "Status-ID",
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1337
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Webhook deleted."
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "404": {
                        "description": "No webhook found for this id"
                    },
                    "403": {
                        "description": "User or application not authorized to delete this webhook"
                    }
                },
                "security": [
                    {
                        "passport": []
                    },
                    {
                        "token": []
                    }
                ]
            }
        },
        "/year-in-review": {
            "get": {
                "tags": [
                    "Statistics"
                ],
                "summary": "Returns the year in review for the given year and authenticated user",
                "description": "Please note: This endpoint is only available when the year in review feature is enabled in the backend configuration. There is no full documentation - this endpoint may change every year.",
                "operationId": "getYearInReview",
                "responses": {
                    "200": {
                        "description": "JSON object with the year in review data. The structure of the object may change every year. There is no full documentation at this point."
                    },
                    "400": {
                        "description": "Bad request"
                    },
                    "401": {
                        "description": "Unauthorized"
                    },
                    "403": {
                        "description": "Year in review is not active"
                    }
                },
                "security": [
                    {
                        "passport": [
                            "create-statuses"
                        ]
                    },
                    {
                        "token": []
                    }
                ]
            }
        }
    },
    "components": {
        "schemas": {
            "Feature": {
                "description": "Represents a configuration feature and its status.",
                "required": [
                    "name",
                    "enabled"
                ],
                "properties": {
                    "name": {
                        "schema": "#/components/schemas/ConfigurationFeatureEnum",
                        "description": "The name of the feature.",
                        "type": "string",
                        "example": "user_registration"
                    },
                    "enabled": {
                        "description": "Indicates whether the feature is enabled.",
                        "type": "boolean"
                    }
                },
                "type": "object"
            },
            "ConfigurationInformation": {
                "description": "Holds configuration information about the application.",
                "required": [
                    "appName",
                    "appDebug",
                    "appUrl",
                    "features",
                    "languages",
                    "version"
                ],
                "properties": {
                    "appName": {
                        "description": "The name of the application.",
                        "type": "string",
                        "example": "Träwelling"
                    },
                    "appDebug": {
                        "description": "Indicates whether the application is in debug mode.",
                        "type": "boolean",
                        "example": false
                    },
                    "appUrl": {
                        "description": "The base URL of the application.",
                        "type": "string",
                        "example": "https://traewelling.de"
                    },
                    "version": {
                        "description": "The current version of the application.",
                        "type": "string",
                        "example": "1.0.0"
                    },
                    "features": {
                        "description": "A list of configuration features available in the application.",
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/Feature"
                        }
                    },
                    "languages": {
                        "description": "A list of supported languages in the application.",
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/Language"
                        }
                    }
                },
                "type": "object"
            },
            "Language": {
                "description": "Represents a language with its code and name.",
                "required": [
                    "code",
                    "name"
                ],
                "properties": {
                    "code": {
                        "description": "The language code (e.g., \"en\", \"fr\").",
                        "type": "string",
                        "example": "en"
                    },
                    "name": {
                        "description": "The name of the language (e.g., \"English\", \"French\").",
                        "type": "string",
                        "example": "English"
                    }
                },
                "type": "object"
            },
            "Coordinate": {
                "title": "Coordinate",
                "description": "GeoJson Coordinates",
                "properties": {
                    "type": {
                        "type": "number",
                        "format": "float",
                        "example": "Feature"
                    },
                    "properties": {
                        "type": "object",
                        "example": "{}"
                    },
                    "geometry": {
                        "properties": {
                            "type": {
                                "type": "string",
                                "example": "Point"
                            },
                            "coordinates": {
                                "type": "array",
                                "items": {
                                    "example": "[8.39767,49.01625]"
                                }
                            }
                        },
                        "type": "object"
                    }
                },
                "type": "object",
                "xml": {
                    "name": "Coordinate"
                }
            },
            "FeatureCollection": {
                "title": "FeatureCollection",
                "description": "featurecollection of multiple GeoJson points",
                "properties": {
                    "type": {
                        "title": "type",
                        "type": "string",
                        "example": "FeatureCollection"
                    },
                    "features": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/Coordinate"
                        }
                    }
                },
                "type": "object",
                "xml": {
                    "name": "FeatureCollection"
                }
            },
            "LicenseDto": {
                "title": "License DTO",
                "description": "Data Transfer Object for licenses",
                "required": [
                    "licenseName",
                    "attributionString",
                    "licenseUrl",
                    "sourceUrl"
                ],
                "properties": {
                    "licenseName": {
                        "description": "Name of the license",
                        "type": "string",
                        "example": "CC BY 4.0"
                    },
                    "attributionString": {
                        "description": "Attribution string for the license",
                        "type": "string",
                        "example": "Provided by OpenStreetMap contributors",
                        "nullable": true
                    },
                    "licenseUrl": {
                        "description": "URL to the license text",
                        "type": "string",
                        "example": "https://creativecommons.org/licenses/by/4.0/",
                        "nullable": true
                    },
                    "sourceUrl": {
                        "description": "URL to the source of the data",
                        "type": "string",
                        "example": "https://www.openstreetmap.org/",
                        "nullable": true
                    }
                },
                "type": "object"
            },
            "LivePointDto": {
                "title": "LivePointDto",
                "description": "All necessary information to calculate live position",
                "properties": {
                    "point": {
                        "oneOf": [
                            {
                                "$ref": "#/components/schemas/Coordinate"
                            }
                        ],
                        "nullable": true,
                        "title": "point",
                        "description": "current point, if stopping at a station"
                    },
                    "polyline": {
                        "$ref": "#/components/schemas/FeatureCollection"
                    },
                    "arrival": {
                        "title": "arrival",
                        "description": "arrival at end of polyline in UNIX time format",
                        "type": "integer",
                        "format": "integer",
                        "example": 1692538680
                    },
                    "departure": {
                        "title": "departure",
                        "description": "departure at start of polyline in UNIX time format",
                        "type": "integer",
                        "format": "integer",
                        "example": 1692538740
                    },
                    "lineName": {
                        "title": "lineName",
                        "description": "name of line",
                        "type": "string",
                        "format": "string",
                        "example": "ICE 123"
                    },
                    "statusId": {
                        "title": "statusId",
                        "description": "ID of status",
                        "type": "integer",
                        "format": "int",
                        "example": 12345,
                        "deprecated": true
                    }
                },
                "type": "object",
                "xml": {
                    "name": "LivePointDto"
                }
            },
            "MentionDto": {
                "title": "Mention",
                "description": "Mentioned user and position in status body",
                "required": [
                    "user",
                    "position",
                    "length"
                ],
                "properties": {
                    "user": {
                        "oneOf": [
                            {
                                "$ref": "#/components/schemas/UserResource"
                            }
                        ],
                        "nullable": true,
                        "title": "user"
                    },
                    "position": {
                        "title": "position",
                        "type": "integer",
                        "format": "int",
                        "example": 0
                    },
                    "length": {
                        "title": "length",
                        "type": "integer",
                        "format": "integer",
                        "example": 4
                    }
                },
                "type": "object",
                "xml": {
                    "name": "Mention"
                }
            },
            "Station": {
                "title": "Station",
                "description": "train station model",
                "properties": {
                    "id": {
                        "title": "id",
                        "description": "id",
                        "type": "integer",
                        "example": "4711"
                    },
                    "name": {
                        "title": "name",
                        "description": "name of the station",
                        "type": "string",
                        "example": "Karlsruhe Hbf"
                    },
                    "latitude": {
                        "title": "latitude",
                        "description": "latitude of the station",
                        "type": "number",
                        "format": "float",
                        "example": "48.991591"
                    },
                    "longitude": {
                        "title": "longitude",
                        "description": "longitude of the station",
                        "type": "number",
                        "format": "float",
                        "example": "8.400538"
                    },
                    "ibnr": {
                        "title": "ibnr",
                        "description": "IBNR of the station",
                        "type": "integer",
                        "example": "8000191",
                        "nullable": true
                    },
                    "rilIdentifier": {
                        "title": "rilIdentifier",
                        "description": "Identifier specified in 'Richtline 100' of the Deutsche Bahn",
                        "type": "string",
                        "example": "RK",
                        "nullable": true
                    }
                },
                "type": "object",
                "xml": {
                    "name": "Station"
                }
            },
            "Business": {
                "title": "Business",
                "description": "What type of travel (0=private, 1=business, 2=commute) did the user specify?",
                "type": "integer",
                "example": 0,
                "enum": [
                    0,
                    1,
                    2
                ]
            },
            "ConfigurationFeatureEnum": {
                "description": "Enumeration of configuration features available in the application.",
                "type": "string",
                "enum": [
                    "user_registration",
                    "year_in_review"
                ]
            },
            "DataProvider": {
                "title": "DataProvider",
                "description": "What type of data provider did the user specify? (users need to be in closed-beta for this to take effect)",
                "type": "string",
                "example": "cargo",
                "enum": [
                    "default",
                    "transitous"
                ]
            },
            "HafasTravelType": {
                "title": "category",
                "description": "Category of transport.",
                "type": "string",
                "example": "suburban",
                "enum": [
                    "nationalExpress",
                    "national",
                    "regionalExp",
                    "regional",
                    "suburban",
                    "bus",
                    "ferry",
                    "subway",
                    "tram",
                    "taxi",
                    "plane"
                ]
            },
            "MapProvider": {
                "title": "MapProvider",
                "description": "What type of map provider (cargo, open-railway-map) did the user specify?",
                "type": "string",
                "example": "cargo",
                "enum": [
                    "cargo",
                    "open-railway-map"
                ]
            },
            "MastodonVisibility": {
                "title": "visibility",
                "description": "What type of visibility (0=public, 1=unlisted, 2=followers, 3=private) did the user specify for future posts to Mastodon? Some instances such as chaos.social discourage bot posts on public timelines.",
                "type": "integer",
                "example": 1,
                "enum": [
                    0,
                    1,
                    2,
                    3
                ]
            },
            "MotisCategory": {
                "title": "mode",
                "description": "Mode of transport",
                "type": "string",
                "example": "suburban",
                "enum": [
                    "WALK",
                    "BIKE",
                    "RENTAL",
                    "CAR",
                    "CAR_PARKING",
                    "CAR_DROPOFF",
                    "ODM",
                    "RIDE_SHARING",
                    "FLEX",
                    "TRANSIT",
                    "TRAM",
                    "SUBWAY",
                    "FERRY",
                    "AIRPLANE",
                    "SUBURBAN",
                    "BUS",
                    "COACH",
                    "RAIL",
                    "HIGHSPEED_RAIL",
                    "LONG_DISTANCE",
                    "NIGHT_RAIL",
                    "REGIONAL_FAST_RAIL",
                    "REGIONAL_RAIL",
                    "CABLE_CAR",
                    "FUNICULAR",
                    "AERIAL_LIFT",
                    "OTHER",
                    "AERAL_LIFT",
                    "METRO"
                ]
            },
            "PointReason": {
                "title": "PointsReason",
                "description": "What is the reason for the points calculation factor? (0=in time => 100%, 1=good enough => 25%, 2=not sufficient (1 point), 3=forced => no points, 4=manual trip => no points, 5=points disabled)",
                "type": "integer",
                "example": 1,
                "enum": [
                    0,
                    1,
                    2,
                    3,
                    4,
                    5
                ]
            },
            "StatusVisibility": {
                "title": "visibility",
                "description": "What type of visibility (0=public, 1=unlisted, 2=followers, 3=private, 4=authenticated, 5=trusted) did the user specify?",
                "type": "integer",
                "example": 0,
                "enum": [
                    0,
                    1,
                    2,
                    3,
                    4,
                    5
                ]
            },
            "TravelType": {
                "title": "travelType",
                "description": "When adding a new travel type, make sure to add it to the translation file as well.",
                "type": "string",
                "example": "suburban",
                "enum": [
                    "express",
                    "regional",
                    "suburban",
                    "bus",
                    "ferry",
                    "subway",
                    "tram",
                    "taxi",
                    "plane"
                ]
            },
            "FriendCheckinSetting": {
                "title": "FriendCheckinSetting",
                "type": "string",
                "example": "forbidden",
                "enum": [
                    "forbidden",
                    "friends",
                    "list"
                ]
            },
            "ViewUserForbiddenReason": {
                "title": "ViewUserForbiddenReason",
                "type": "string",
                "example": "PRIVATE_PROFILE",
                "enum": [
                    "PRIVATE_PROFILE",
                    "USER_MUTED",
                    "YOU_ARE_BLOCKED",
                    "USER_BLOCKED"
                ]
            },
            "BearerTokenResponse": {
                "title": "BearerTokenResponse",
                "properties": {
                    "token": {
                        "description": "Bearer Token. Use in Authentication-Header with prefix 'Bearer '. (space is needed)",
                        "type": "string",
                        "example": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9..."
                    },
                    "expires_at": {
                        "description": "End of life for this token.",
                        "type": "string",
                        "example": "2023-10-19T15:15:06+02:00"
                    }
                },
                "type": "object"
            },
            "EventSuggestion": {
                "title": "EventSuggestion",
                "description": "Fields for suggesting an event",
                "properties": {
                    "name": {
                        "description": "name of the event",
                        "type": "string",
                        "example": "Eröffnung der Nebenbahn in Knuffingen",
                        "maxLength": 255
                    },
                    "host": {
                        "description": "host of the event",
                        "type": "string",
                        "example": "MiWuLa",
                        "nullable": true
                    },
                    "begin": {
                        "description": "Timestamp for the start of the event",
                        "type": "string",
                        "format": "date-time",
                        "example": "2022-06-01T00:00:00+02:00"
                    },
                    "end": {
                        "description": "Timestamp for the end of the event",
                        "type": "string",
                        "format": "date-time",
                        "example": "2022-08-31T23:59:00+02:00"
                    },
                    "url": {
                        "description": "external URL for this event",
                        "type": "string",
                        "example": "https://www.example.com/event",
                        "nullable": true,
                        "maxLength": 255
                    },
                    "hashtag": {
                        "description": "hashtag for this event",
                        "type": "string",
                        "example": "gpn21",
                        "nullable": true,
                        "maxLength": 40
                    },
                    "nearestStation": {
                        "description": "Query string for the nearest station. Deprecated: use nearestStationId instead.",
                        "type": "string",
                        "example": "Berlin Hbf",
                        "nullable": true,
                        "deprecated": true,
                        "maxLength": 255
                    },
                    "nearestStationId": {
                        "description": "ID of the nearest station to this event",
                        "type": "integer",
                        "example": 1,
                        "nullable": true
                    }
                },
                "type": "object"
            },
            "LikeResponse": {
                "title": "LikeResponse",
                "properties": {
                    "count": {
                        "description": "Amount of likes",
                        "type": "integer",
                        "format": "int32",
                        "example": 12
                    }
                },
                "type": "object"
            },
            "StatusUpdateBody": {
                "title": "StatusUpdateBody",
                "description": "Status Update Body",
                "properties": {
                    "body": {
                        "description": "Status-Text to be displayed alongside the checkin",
                        "type": "string",
                        "example": "Wow. This train is extremely crowded!",
                        "nullable": true,
                        "maxLength": 280
                    },
                    "business": {
                        "$ref": "#/components/schemas/Business"
                    },
                    "visibility": {
                        "$ref": "#/components/schemas/StatusVisibility"
                    },
                    "eventId": {
                        "description": "The ID of the event this status is related to - or null",
                        "type": "string",
                        "example": "1",
                        "nullable": true
                    },
                    "manualDeparture": {
                        "description": "Manual departure time set by the user",
                        "type": "string",
                        "format": "date",
                        "example": "2020-01-01 12:00:00",
                        "nullable": true
                    },
                    "manualArrival": {
                        "description": "Manual arrival time set by the user",
                        "type": "string",
                        "format": "date",
                        "example": "2020-01-01 13:00:00",
                        "nullable": true
                    },
                    "destinationId": {
                        "description": "Destination station id",
                        "type": "string",
                        "example": "1",
                        "nullable": true
                    },
                    "destinationArrivalPlanned": {
                        "description": "Destination arrival time",
                        "type": "string",
                        "format": "date",
                        "example": "2020-01-01 13:00:00",
                        "nullable": true
                    }
                },
                "type": "object"
            },
            "Polyline": {
                "title": "Polyline",
                "description": "Polyline of a single status as GeoJSON Feature",
                "properties": {
                    "type": {
                        "type": "string",
                        "example": "Feature"
                    },
                    "geometry": {
                        "properties": {
                            "type": {
                                "type": "string",
                                "example": "LineString"
                            },
                            "coordinates": {
                                "type": "array",
                                "items": {
                                    "example": "[[8.39767,49.01625],[8.45947,49.06576]]"
                                }
                            }
                        },
                        "type": "object"
                    },
                    "properties": {
                        "properties": {
                            "statusId": {
                                "type": "integer",
                                "example": 1337
                            }
                        },
                        "type": "object"
                    }
                },
                "type": "object"
            },
            "CheckinRequestBody": {
                "title": "CheckinRequestBody",
                "description": "Fields for creating a transit checkin",
                "properties": {
                    "body": {
                        "type": "string",
                        "example": "Meine erste Fahrt nach Knuffingen!",
                        "nullable": true,
                        "maxLength": 280
                    },
                    "business": {
                        "$ref": "#/components/schemas/Business"
                    },
                    "visibility": {
                        "$ref": "#/components/schemas/StatusVisibility"
                    },
                    "eventId": {
                        "description": "Id of an event the status should be connected to",
                        "type": "integer",
                        "example": 1,
                        "nullable": true
                    },
                    "toot": {
                        "description": "Should this status be posted to mastodon?",
                        "type": "boolean",
                        "example": false,
                        "nullable": true
                    },
                    "chainPost": {
                        "description": "Should this status be posted to mastodon as a chained post?",
                        "type": "boolean",
                        "example": false,
                        "nullable": true
                    },
                    "ibnr": {
                        "description": "If true, `start` and `destination` can be supplied as IBNR. Otherwise Träwelling-ID. Default: false.",
                        "type": "boolean",
                        "example": true,
                        "nullable": true
                    },
                    "tripId": {
                        "description": "The tripId for the trip to check into",
                        "type": "string",
                        "example": "b37ff515-22e1-463c-94de-3ad7964b5cb8",
                        "nullable": true
                    },
                    "lineName": {
                        "description": "The line name for the trip to check into",
                        "type": "string",
                        "example": "S 4",
                        "nullable": true
                    },
                    "start": {
                        "description": "Station-ID of the starting point (see `ibnr`)",
                        "type": "integer",
                        "example": 8000191
                    },
                    "destination": {
                        "description": "Station-ID of the destination (see `ibnr`)",
                        "type": "integer",
                        "example": 8000192
                    },
                    "departure": {
                        "description": "Timestamp of the departure",
                        "type": "string",
                        "format": "date-time",
                        "example": "2022-12-19T20:41:00+01:00"
                    },
                    "arrival": {
                        "description": "Timestamp of the arrival",
                        "type": "string",
                        "format": "date-time",
                        "example": "2022-12-19T20:42:00+01:00"
                    },
                    "force": {
                        "description": "If true, the checkin is created even on collision. No points awarded.",
                        "type": "boolean",
                        "example": false,
                        "nullable": true
                    },
                    "with": {
                        "description": "Also check in these user IDs (max. 10). Requires mutual follow.",
                        "type": "array",
                        "items": {
                            "type": "integer",
                            "example": 1
                        },
                        "nullable": true
                    }
                },
                "type": "object"
            },
            "UpdateProfileInformationRequest": {
                "title": "UpdateProfileInformationRequest",
                "description": "UpdateProfileInformationRequest",
                "properties": {
                    "username": {
                        "type": "string",
                        "example": "gertrud123",
                        "maxLength": 25
                    },
                    "displayName": {
                        "type": "string",
                        "example": "Gertrud",
                        "maxLength": 50
                    },
                    "privateProfile": {
                        "type": "boolean",
                        "example": false,
                        "nullable": true
                    },
                    "preventIndex": {
                        "type": "boolean",
                        "example": false,
                        "nullable": true
                    },
                    "privacyHideDays": {
                        "type": "integer",
                        "example": 1,
                        "nullable": true
                    },
                    "defaultStatusVisibility": {
                        "oneOf": [
                            {
                                "$ref": "#/components/schemas/StatusVisibility"
                            }
                        ],
                        "nullable": true
                    },
                    "mastodonVisibility": {
                        "oneOf": [
                            {
                                "$ref": "#/components/schemas/MastodonVisibility"
                            }
                        ],
                        "nullable": true
                    },
                    "mapProvider": {
                        "oneOf": [
                            {
                                "$ref": "#/components/schemas/MapProvider"
                            }
                        ],
                        "nullable": true
                    },
                    "friendCheckin": {
                        "oneOf": [
                            {
                                "$ref": "#/components/schemas/FriendCheckinSetting"
                            }
                        ],
                        "nullable": true
                    },
                    "likesEnabled": {
                        "type": "boolean",
                        "example": true,
                        "nullable": true
                    },
                    "pointsEnabled": {
                        "type": "boolean",
                        "example": true,
                        "nullable": true
                    },
                    "bio": {
                        "type": "string",
                        "example": "Hi there! I am Gertrud!",
                        "nullable": true,
                        "maxLength": 500
                    },
                    "experimental": {
                        "description": "Experimental features enabled",
                        "type": "boolean",
                        "example": false
                    },
                    "profileLinks": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/ProfileLinkResource"
                        },
                        "nullable": true
                    },
                    "timezone": {
                        "type": "string",
                        "example": "Europe/Berlin"
                    }
                },
                "type": "object"
            },
            "AlertResource": {
                "required": [
                    "id",
                    "type",
                    "active_from",
                    "active_until",
                    "url",
                    "translations"
                ],
                "properties": {
                    "id": {
                        "type": "string",
                        "example": "123e4567-e89b-12d3-a456-426614174000"
                    },
                    "type": {
                        "type": "enum",
                        "example": "info",
                        "enum": [
                            "info",
                            "warning",
                            "danger",
                            "success"
                        ]
                    },
                    "active_from": {
                        "type": "string",
                        "format": "date-time",
                        "example": "2023-10-01T00:00:00Z"
                    },
                    "active_until": {
                        "type": "string",
                        "format": "date-time",
                        "example": "2023-10-31T23:59:59Z",
                        "nullable": true
                    },
                    "url": {
                        "type": "string",
                        "example": "https://example.com",
                        "nullable": true
                    },
                    "translations": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/AlertTranslationResource"
                        }
                    }
                },
                "type": "object"
            },
            "AlertTranslationResource": {
                "required": [
                    "title",
                    "content",
                    "url",
                    "locale"
                ],
                "properties": {
                    "title": {
                        "type": "string",
                        "example": "Alert Title"
                    },
                    "content": {
                        "type": "string",
                        "example": "Alert Content"
                    },
                    "url": {
                        "type": "string",
                        "example": "https://example.com"
                    },
                    "locale": {
                        "type": "string",
                        "example": "en"
                    }
                },
                "type": "object"
            },
            "AreaResource": {
                "title": "Area",
                "required": [
                    "name",
                    "default",
                    "adminLevel"
                ],
                "properties": {
                    "name": {
                        "type": "string",
                        "example": "Karlsruhe"
                    },
                    "default": {
                        "type": "boolean",
                        "example": true
                    },
                    "adminLevel": {
                        "type": "integer",
                        "example": "1"
                    }
                },
                "type": "object"
            },
            "PointsCalculation": {
                "title": "PointsCalculation",
                "properties": {
                    "base": {
                        "description": "Basepoints for this type of vehicle",
                        "type": "number",
                        "format": "float",
                        "example": 0.5
                    },
                    "distance": {
                        "description": "Points for the travelled distance",
                        "type": "number",
                        "format": "float",
                        "example": 0.25
                    },
                    "factor": {
                        "type": "number",
                        "format": "float",
                        "example": 0.25
                    },
                    "reason": {
                        "$ref": "#/components/schemas/PointReason"
                    }
                },
                "type": "object"
            },
            "Points": {
                "title": "Points",
                "description": "Points model",
                "properties": {
                    "points": {
                        "description": "points",
                        "type": "integer",
                        "example": 1
                    },
                    "calculation": {
                        "$ref": "#/components/schemas/PointsCalculation"
                    },
                    "additional": {
                        "description": "Deprecated. Always null.",
                        "type": "array",
                        "items": {},
                        "nullable": true,
                        "deprecated": true
                    }
                },
                "type": "object"
            },
            "CheckinSuccessResource": {
                "title": "CheckinResponse",
                "properties": {
                    "status": {
                        "$ref": "#/components/schemas/StatusResource"
                    },
                    "points": {
                        "$ref": "#/components/schemas/Points"
                    },
                    "alsoOnThisConnection": {
                        "description": "Statuses of other people on this connection",
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/StatusResource"
                        }
                    }
                },
                "type": "object"
            },
            "ClientResource": {
                "title": "Client",
                "required": [
                    "id",
                    "name",
                    "privacyPolicyUrl"
                ],
                "properties": {
                    "id": {
                        "type": "integer",
                        "example": 1
                    },
                    "name": {
                        "type": "string",
                        "example": "Träwelling App"
                    },
                    "privacyPolicyUrl": {
                        "type": "string",
                        "example": "https://traewelling.de/privacy-policy"
                    }
                },
                "type": "object"
            },
            "CommunityProfile": {
                "title": "CommunityProfile",
                "description": "Community contribution profile data",
                "required": [
                    "xp",
                    "level",
                    "nextLevelXP",
                    "progressPercent"
                ],
                "properties": {
                    "xp": {
                        "description": "Total contribution XP earned",
                        "type": "integer",
                        "example": 75
                    },
                    "level": {
                        "description": "Current contribution level",
                        "type": "integer",
                        "example": 1
                    },
                    "nextLevelXP": {
                        "description": "XP required for next level",
                        "type": "integer",
                        "example": 150
                    },
                    "progressPercent": {
                        "description": "Progress percentage to next level",
                        "type": "number",
                        "format": "float",
                        "example": 25
                    }
                },
                "type": "object"
            },
            "ContributionHistory": {
                "title": "ContributionHistory",
                "description": "A single contribution history entry",
                "required": [
                    "id",
                    "actionType",
                    "entityType",
                    "entityId",
                    "xpChange",
                    "levelBefore",
                    "levelAfter",
                    "createdAt"
                ],
                "properties": {
                    "id": {
                        "type": "string",
                        "format": "uuid",
                        "example": "9e3a1b2c-4d5e-6f7a-8b9c-0d1e2f3a4b5c"
                    },
                    "actionType": {
                        "type": "string",
                        "example": "event_suggested"
                    },
                    "entityType": {
                        "type": "string",
                        "example": "event_suggestion"
                    },
                    "entityId": {
                        "type": "integer",
                        "example": 42
                    },
                    "xpChange": {
                        "type": "integer",
                        "example": 5
                    },
                    "levelBefore": {
                        "type": "integer",
                        "example": 0
                    },
                    "levelAfter": {
                        "type": "integer",
                        "example": 1
                    },
                    "note": {
                        "type": "string",
                        "example": "Event approved: GPN 22",
                        "nullable": true
                    },
                    "createdAt": {
                        "type": "string",
                        "format": "date-time",
                        "example": "2026-02-15T12:00:00Z"
                    }
                },
                "type": "object"
            },
            "DataSourceResource": {
                "title": "DataSourceResource",
                "required": [
                    "id",
                    "attribution"
                ],
                "properties": {
                    "id": {
                        "type": "string",
                        "example": "foobar"
                    },
                    "attribution": {
                        "type": "string",
                        "example": "Provided by foobar under CC BY 4.0"
                    }
                },
                "type": "object"
            },
            "DepartureResource": {
                "title": "Departure",
                "description": "A single departure at a station",
                "required": [
                    "tripId",
                    "stop",
                    "when",
                    "plannedWhen",
                    "delay",
                    "platform",
                    "plannedPlatform",
                    "direction",
                    "line",
                    "station"
                ],
                "properties": {
                    "tripId": {
                        "description": "Unique trip identifier",
                        "type": "string",
                        "example": "1|200513|0|81|6012023"
                    },
                    "stop": {
                        "description": "The stop at which this departure occurs",
                        "properties": {
                            "type": {
                                "type": "string",
                                "example": "stop"
                            },
                            "id": {
                                "description": "Träwelling internal station ID",
                                "type": "integer",
                                "example": 5181
                            },
                            "name": {
                                "type": "string",
                                "example": "Karlsruhe Hbf"
                            },
                            "location": {
                                "properties": {
                                    "type": {
                                        "type": "string",
                                        "example": "location"
                                    },
                                    "id": {
                                        "description": "IBNR identifier (if available)",
                                        "type": "string",
                                        "example": "8000191",
                                        "nullable": true
                                    },
                                    "latitude": {
                                        "type": "number",
                                        "format": "float",
                                        "example": 48.993207
                                    },
                                    "longitude": {
                                        "type": "number",
                                        "format": "float",
                                        "example": 8.400977
                                    }
                                },
                                "type": "object"
                            },
                            "products": {
                                "description": "Deprecated. Always true for all modes.",
                                "type": "object",
                                "deprecated": true
                            }
                        },
                        "type": "object"
                    },
                    "when": {
                        "description": "Actual departure time (null if no realtime data)",
                        "type": "string",
                        "format": "date-time",
                        "example": "2023-01-06T13:49:00+01:00",
                        "nullable": true
                    },
                    "plannedWhen": {
                        "description": "Scheduled departure time",
                        "type": "string",
                        "format": "date-time",
                        "example": "2023-01-06T13:49:00+01:00"
                    },
                    "delay": {
                        "description": "Deprecated. Use the difference between when and plannedWhen instead.",
                        "type": "integer",
                        "example": 2,
                        "nullable": true,
                        "deprecated": true
                    },
                    "platform": {
                        "description": "Actual platform (null if no realtime data)",
                        "type": "string",
                        "example": "3a",
                        "nullable": true
                    },
                    "plannedPlatform": {
                        "description": "Scheduled platform",
                        "type": "string",
                        "example": "3",
                        "nullable": true
                    },
                    "direction": {
                        "description": "Final destination of the trip",
                        "type": "string",
                        "example": "Zürich HB"
                    },
                    "provenance": {
                        "description": "Deprecated. Always null.",
                        "type": "string",
                        "example": null,
                        "nullable": true,
                        "deprecated": true
                    },
                    "line": {
                        "properties": {
                            "type": {
                                "type": "string",
                                "example": "line"
                            },
                            "id": {
                                "type": "string",
                                "example": "EC 9"
                            },
                            "fahrtNr": {
                                "description": "Journey number",
                                "type": "string",
                                "example": "9"
                            },
                            "name": {
                                "type": "string",
                                "example": "EC 9"
                            },
                            "color": {
                                "description": "Route color as hex (without #)",
                                "type": "string",
                                "example": "ff2e3e",
                                "nullable": true
                            },
                            "textColor": {
                                "description": "Route text color as hex (without #)",
                                "type": "string",
                                "example": "ffffff",
                                "nullable": true
                            },
                            "public": {
                                "description": "Deprecated. Always true.",
                                "type": "boolean",
                                "example": true,
                                "deprecated": true
                            },
                            "productName": {
                                "description": "Deprecated. Use name.",
                                "type": "string",
                                "example": "EC 9",
                                "deprecated": true
                            },
                            "mode": {
                                "description": "Transit mode",
                                "type": "string",
                                "example": "TRAIN",
                                "nullable": true
                            },
                            "product": {
                                "description": "Deprecated HAFAS product category",
                                "type": "string",
                                "example": "national",
                                "nullable": true,
                                "deprecated": true
                            },
                            "adminCode": {
                                "description": "Deprecated. Always \"80____\".",
                                "type": "string",
                                "example": "80____",
                                "deprecated": true
                            },
                            "operator": {
                                "description": "Deprecated. Always null.",
                                "type": "object",
                                "nullable": true,
                                "deprecated": true
                            }
                        },
                        "type": "object"
                    },
                    "remarks": {
                        "description": "Deprecated. Always null.",
                        "type": "array",
                        "items": {},
                        "nullable": true,
                        "deprecated": true
                    },
                    "origin": {
                        "description": "Deprecated. Always null.",
                        "type": "object",
                        "nullable": true,
                        "deprecated": true
                    },
                    "destination": {
                        "description": "Deprecated. Use direction instead.",
                        "type": "object",
                        "deprecated": true
                    },
                    "currentTripPosition": {
                        "description": "Deprecated. Always null.",
                        "type": "object",
                        "nullable": true,
                        "deprecated": true
                    },
                    "loadFactor": {
                        "description": "Deprecated. Always null.",
                        "type": "string",
                        "nullable": true,
                        "deprecated": true
                    },
                    "station": {
                        "$ref": "#/components/schemas/StationResource"
                    }
                },
                "type": "object"
            },
            "EventDetailsResource": {
                "title": "EventDetails",
                "properties": {
                    "id": {
                        "type": "integer",
                        "example": 39
                    },
                    "slug": {
                        "type": "string",
                        "example": "9_euro_ticket"
                    },
                    "totalDistance": {
                        "description": "distance travelled in meters",
                        "type": "integer",
                        "example": 12345
                    },
                    "totalDuration": {
                        "description": "duration travelled in minutes",
                        "type": "integer",
                        "example": 12345
                    },
                    "trainDistance": {
                        "description": "Deprecated. Use totalDistance instead.",
                        "type": "integer",
                        "example": 12345,
                        "deprecated": true
                    },
                    "trainDuration": {
                        "description": "Deprecated. Use totalDuration instead.",
                        "type": "integer",
                        "example": 12345,
                        "deprecated": true
                    }
                },
                "type": "object"
            },
            "EventResource": {
                "title": "Event",
                "required": [
                    "id",
                    "name",
                    "slug",
                    "hashtag",
                    "host",
                    "url",
                    "begin",
                    "end",
                    "station",
                    "isPride"
                ],
                "properties": {
                    "id": {
                        "type": "integer",
                        "example": 39
                    },
                    "name": {
                        "type": "string",
                        "example": "9-Euro-Ticket"
                    },
                    "slug": {
                        "type": "string",
                        "example": "9_euro_ticket"
                    },
                    "hashtag": {
                        "type": "string",
                        "example": "NeunEuroTicket"
                    },
                    "host": {
                        "type": "string",
                        "example": "9-Euro-Ticket GmbH"
                    },
                    "url": {
                        "type": "string",
                        "example": "https://9-euro-ticket.de"
                    },
                    "begin": {
                        "type": "string",
                        "format": "date",
                        "example": "2022-01-01"
                    },
                    "end": {
                        "type": "string",
                        "format": "date",
                        "example": "2022-01-02"
                    },
                    "station": {
                        "$ref": "#/components/schemas/Station"
                    },
                    "isPride": {
                        "$ref": "#/components/schemas/StationResource"
                    }
                },
                "type": "object"
            },
            "IcsEntryResource": {
                "required": [
                    "id",
                    "token",
                    "name",
                    "created",
                    "lastAccessed"
                ],
                "properties": {
                    "id": {
                        "description": "The unique identifier of the ICS token",
                        "type": "integer",
                        "example": 1
                    },
                    "token": {
                        "description": "The first 8 characters of the ICS token",
                        "type": "string",
                        "example": "abcd1234"
                    },
                    "name": {
                        "description": "The name of the ICS token",
                        "type": "string",
                        "example": "My ICS Token"
                    },
                    "createdAt": {
                        "description": "The ISO 8601 timestamp when the ICS token was created",
                        "type": "string",
                        "format": "date-time",
                        "example": "2024-01-01T12:00:00Z",
                        "nullable": true
                    },
                    "lastAccessed": {
                        "description": "The ISO 8601 timestamp when the ICS token was last accessed",
                        "type": "string",
                        "format": "date-time",
                        "example": "2024-01-15T08:30:00Z",
                        "nullable": true
                    }
                },
                "type": "object"
            },
            "LeaderboardUserResource": {
                "title": "LeaderboardUserResource",
                "required": [
                    "user",
                    "totalDuration",
                    "totalDistance",
                    "points"
                ],
                "properties": {
                    "user": {
                        "$ref": "#/components/schemas/LightUserResource"
                    },
                    "totalDuration": {
                        "description": "duration travelled in minutes",
                        "type": "integer",
                        "example": 6
                    },
                    "totalDistance": {
                        "description": "distance travelled in meters",
                        "type": "integer",
                        "example": 12345
                    },
                    "points": {
                        "description": "points of user",
                        "type": "integer"
                    }
                },
                "type": "object"
            },
            "LightUserResource": {
                "title": "LightUser",
                "description": "User model with just basic information",
                "required": [
                    "id",
                    "displayName",
                    "username",
                    "profilePicture",
                    "preventIndex"
                ],
                "properties": {
                    "id": {
                        "type": "integer",
                        "example": 1
                    },
                    "displayName": {
                        "type": "string",
                        "example": "Gertrud"
                    },
                    "username": {
                        "type": "string",
                        "example": "Gertrud123"
                    },
                    "profilePicture": {
                        "type": "string",
                        "example": "https://traewelling.de/@Gertrud123/picture"
                    },
                    "mastodon": {
                        "type": "object",
                        "example": {
                            "server": "mastodon.social",
                            "user_id": 1234567
                        }
                    },
                    "preventIndex": {
                        "type": "boolean",
                        "example": false
                    }
                },
                "type": "object"
            },
            "Links": {
                "title": "Links",
                "description": "Pagination links",
                "properties": {
                    "first": {
                        "description": "Shared OA schema for Laravel pagination links. Not a real resource.",
                        "type": "string",
                        "format": "uri",
                        "example": "https://traewelling.de/api/v1/ENDPOINT?page=1",
                        "nullable": true
                    },
                    "last": {
                        "type": "string",
                        "format": "uri",
                        "example": null,
                        "nullable": true
                    },
                    "prev": {
                        "type": "string",
                        "format": "uri",
                        "example": null,
                        "nullable": true
                    },
                    "next": {
                        "type": "string",
                        "format": "uri",
                        "example": "https://traewelling.de/api/v1/ENDPOINT?page=2",
                        "nullable": true
                    }
                },
                "type": "object"
            },
            "OperatorResource": {
                "required": [
                    "id",
                    "identifier",
                    "name"
                ],
                "properties": {
                    "id": {
                        "type": "integer",
                        "example": 1
                    },
                    "identifier": {
                        "type": "string",
                        "example": "db-regio-ag-nord",
                        "nullable": true
                    },
                    "name": {
                        "type": "string",
                        "example": "DB Regio AG Nord"
                    }
                },
                "type": "object"
            },
            "PaginationMeta": {
                "title": "Meta",
                "description": "Pagination meta data",
                "properties": {
                    "current_page": {
                        "description": "Shared OA schema for Laravel pagination meta data. Not a real resource.",
                        "type": "integer",
                        "example": 2
                    },
                    "from": {
                        "type": "integer",
                        "example": 16
                    },
                    "path": {
                        "type": "string",
                        "format": "url",
                        "example": "https://traewelling.de/api/v1/ENDPOINT"
                    },
                    "per_page": {
                        "type": "integer",
                        "example": 15
                    },
                    "to": {
                        "type": "integer",
                        "example": 30
                    }
                },
                "type": "object"
            },
            "ProfileLinkResource": {
                "title": "ProfileLinkResource",
                "description": "ProfileLinkResource",
                "required": [
                    "name",
                    "url"
                ],
                "properties": {
                    "name": {
                        "type": "enum",
                        "example": "website",
                        "enum": [
                            "website",
                            "instagram",
                            "bluesky",
                            "facebook",
                            "mastodon",
                            "tiktok",
                            "github"
                        ]
                    },
                    "url": {
                        "type": "string",
                        "example": "https://traewelling.de"
                    }
                },
                "type": "object"
            },
            "SessionResource": {
                "required": [
                    "id",
                    "ip",
                    "userAgent",
                    "platform",
                    "deviceType",
                    "lastActivity"
                ],
                "properties": {
                    "id": {
                        "description": "The session ID",
                        "type": "string",
                        "example": "abc123"
                    },
                    "ip": {
                        "description": "The masked IP address of the session",
                        "type": "string",
                        "example": "192.168.***.***"
                    },
                    "userAgent": {
                        "description": "The user agent string of the session",
                        "type": "string",
                        "example": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36"
                    },
                    "platform": {
                        "description": "The platform of the session",
                        "type": "string",
                        "example": "Windows"
                    },
                    "deviceType": {
                        "description": "The type representing the device used in the session",
                        "type": "string",
                        "example": "mobile"
                    },
                    "lastActivity": {
                        "description": "The timestamp of the last activity in ISO 8601 format",
                        "type": "string",
                        "format": "date-time",
                        "example": "2024-06-01T12:34:56Z"
                    }
                },
                "type": "object"
            },
            "StationIdentifierResource": {
                "title": "StationIdentifier",
                "properties": {
                    "type": {
                        "type": "string",
                        "example": "de_db_ril100"
                    },
                    "identifier": {
                        "type": "string",
                        "example": "RK"
                    }
                },
                "type": "object"
            },
            "StationResource": {
                "title": "Station",
                "required": [
                    "id",
                    "name",
                    "latitude",
                    "longitude",
                    "ibnr",
                    "rilIdentifier",
                    "areas"
                ],
                "properties": {
                    "id": {
                        "type": "integer",
                        "example": "1"
                    },
                    "name": {
                        "type": "string",
                        "example": "Karlsruhe Hbf"
                    },
                    "latitude": {
                        "type": "number",
                        "example": "48.993207"
                    },
                    "longitude": {
                        "type": "number",
                        "example": "8.400977"
                    },
                    "ibnr": {
                        "description": "Deprecated. Always null. Use identifiers with type \"de_db_ibnr\" instead.",
                        "type": "integer",
                        "example": null,
                        "nullable": true,
                        "deprecated": true
                    },
                    "rilIdentifier": {
                        "description": "Deprecated. Always null. Use identifiers with type \"de_db_ril100\" instead.",
                        "type": "string",
                        "example": null,
                        "nullable": true,
                        "deprecated": true
                    },
                    "areas": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/AreaResource"
                        }
                    },
                    "identifiers": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/StationIdentifierResource"
                        }
                    }
                },
                "type": "object"
            },
            "StatisticsGlobalData": {
                "title": "StatisticsGlobalData",
                "required": [
                    "distance",
                    "duration",
                    "activeUsers"
                ],
                "properties": {
                    "distance": {
                        "description": "Globally travelled distance in meters",
                        "type": "integer",
                        "example": 1000
                    },
                    "duration": {
                        "description": "Globally travelled duration in minutes",
                        "type": "integer",
                        "example": 1000
                    },
                    "activeUsers": {
                        "description": "Number of active users",
                        "type": "integer",
                        "example": 1000
                    }
                },
                "type": "object"
            },
            "StatusResource": {
                "title": "Status",
                "required": [
                    "id",
                    "body",
                    "business",
                    "bodyMentions",
                    "business",
                    "visibility",
                    "likes",
                    "liked",
                    "isLikable",
                    "client",
                    "createdAt",
                    "train",
                    "event",
                    "userDetails",
                    "tags",
                    "checkin",
                    "user",
                    "createdBy"
                ],
                "properties": {
                    "id": {
                        "type": "integer",
                        "example": 12345
                    },
                    "body": {
                        "description": "User defined status text",
                        "example": "Hello world!"
                    },
                    "bodyMentions": {
                        "description": "Mentions in the status body",
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/MentionDto"
                        }
                    },
                    "business": {
                        "$ref": "#/components/schemas/Business"
                    },
                    "visibility": {
                        "$ref": "#/components/schemas/StatusVisibility"
                    },
                    "likes": {
                        "description": "How many people have liked this status",
                        "type": "integer",
                        "example": 12
                    },
                    "liked": {
                        "description": "Did the currently authenticated user like this status? (if unauthenticated = false)",
                        "type": "boolean",
                        "example": true
                    },
                    "isLikable": {
                        "description": "Do the author of this status and the currently authenticated user allow liking of statuses? Only show the like UI if set to true",
                        "type": "boolean",
                        "example": true
                    },
                    "client": {
                        "$ref": "#/components/schemas/ClientResource"
                    },
                    "checkin": {
                        "$ref": "#/components/schemas/TransportResource"
                    },
                    "event": {
                        "oneOf": [
                            {
                                "$ref": "#/components/schemas/EventResource"
                            }
                        ],
                        "nullable": true
                    },
                    "user": {
                        "$ref": "#/components/schemas/LightUserResource"
                    },
                    "createdBy": {
                        "oneOf": [
                            {
                                "$ref": "#/components/schemas/LightUserResource"
                            }
                        ],
                        "nullable": true,
                        "description": "User who created this check-in on behalf of the status owner (null if self-checkin)"
                    },
                    "tags": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/StatusTagResource"
                        }
                    },
                    "createdAt": {
                        "description": "creation date of this status",
                        "type": "string",
                        "format": "datetime",
                        "example": "2022-07-17T13:37:00+02:00"
                    }
                },
                "type": "object"
            },
            "StatusTagResource": {
                "title": "StatusTagResource",
                "required": [
                    "key",
                    "value",
                    "visibility"
                ],
                "properties": {
                    "key": {
                        "type": "string",
                        "example": "trwl:vehicle_number"
                    },
                    "value": {
                        "type": "string",
                        "example": "94 80 0450 921 D-AVG"
                    },
                    "visibility": {
                        "type": "integer",
                        "example": "1"
                    }
                },
                "type": "object"
            },
            "StopoverResource": {
                "title": "StopoverResource",
                "required": [
                    "id",
                    "name",
                    "rilIdentifier",
                    "evaIdentifier",
                    "arrival",
                    "arrivalPlanned",
                    "arrivalReal",
                    "arrivalPlatformPlanned",
                    "arrivalPlatformReal",
                    "departure",
                    "departurePlanned",
                    "departureReal",
                    "departurePlatformPlanned",
                    "departurePlatformReal",
                    "platform",
                    "isArrivalDelayed",
                    "isDepartureDelayed",
                    "cancelled"
                ],
                "properties": {
                    "id": {
                        "type": "integer",
                        "example": 12345
                    },
                    "name": {
                        "description": "name of the station",
                        "type": "string",
                        "example": "Karlsruhe Hbf"
                    },
                    "rilIdentifier": {
                        "description": "Deprecated. Always null. Use the station identifiers endpoint instead.",
                        "type": "string",
                        "example": null,
                        "nullable": true,
                        "deprecated": true
                    },
                    "evaIdentifier": {
                        "description": "Deprecated. Always null. Use the station identifiers endpoint instead.",
                        "type": "string",
                        "example": null,
                        "nullable": true,
                        "deprecated": true
                    },
                    "arrival": {
                        "description": "Deprecated. Use arrivalReal (if not null) or arrivalPlanned instead.",
                        "type": "string",
                        "format": "date-time",
                        "example": "2022-07-17T13:37:00+02:00",
                        "nullable": true,
                        "deprecated": true
                    },
                    "arrivalPlanned": {
                        "description": "planned arrival according to timetable records",
                        "type": "string",
                        "format": "date-time",
                        "example": "2022-07-17T13:37:00+02:00",
                        "nullable": true
                    },
                    "arrivalReal": {
                        "description": "real arrival according to live data",
                        "type": "string",
                        "format": "date-time",
                        "example": "2022-07-17T13:37:00+02:00",
                        "nullable": true
                    },
                    "arrivalPlatformPlanned": {
                        "description": "planned arrival platform according to timetable records",
                        "type": "string",
                        "example": "5",
                        "nullable": true
                    },
                    "arrivalPlatformReal": {
                        "description": "real arrival platform according to live data",
                        "type": "string",
                        "example": "5 A-F",
                        "nullable": true
                    },
                    "departure": {
                        "description": "Deprecated. Use departureReal (if not null) or departurePlanned instead.",
                        "type": "string",
                        "format": "date-time",
                        "example": "2022-07-17T13:37:00+02:00",
                        "nullable": true,
                        "deprecated": true
                    },
                    "departurePlanned": {
                        "description": "planned departure according to timetable records",
                        "type": "string",
                        "format": "date-time",
                        "example": "2022-07-17T13:37:00+02:00",
                        "nullable": true
                    },
                    "departureReal": {
                        "description": "real departure according to live data",
                        "type": "string",
                        "format": "date-time",
                        "example": "2022-07-17T13:37:00+02:00",
                        "nullable": true
                    },
                    "departurePlatformPlanned": {
                        "description": "planned departure platform according to timetable records",
                        "type": "string",
                        "example": "5",
                        "nullable": true
                    },
                    "departurePlatformReal": {
                        "description": "real departure platform according to live data",
                        "type": "string",
                        "example": "5 A-F",
                        "nullable": true
                    },
                    "platform": {
                        "type": "string",
                        "example": "5 A-F",
                        "nullable": true
                    },
                    "isArrivalDelayed": {
                        "description": "Is there a delay in the arrival time?",
                        "type": "boolean",
                        "example": false
                    },
                    "isDepartureDelayed": {
                        "description": "Is there a delay in the departure time?",
                        "type": "boolean",
                        "example": false
                    },
                    "cancelled": {
                        "description": "is this stopover cancelled?",
                        "type": "boolean",
                        "example": false
                    }
                },
                "type": "object"
            },
            "TokenResource": {
                "required": [
                    "id",
                    "client",
                    "scopes",
                    "createdAt",
                    "expiresAt"
                ],
                "properties": {
                    "id": {
                        "description": "The token ID",
                        "type": "string",
                        "example": "abc123"
                    },
                    "client": {
                        "description": "The name of the client associated with the token",
                        "type": "string",
                        "example": "MyApp"
                    },
                    "scopes": {
                        "description": "The scopes associated with the token",
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "example": [
                            "read",
                            "write"
                        ]
                    },
                    "createdAt": {
                        "description": "The timestamp when the token was created in ISO 8601 format",
                        "type": "string",
                        "format": "date-time",
                        "example": "2024-06-01T12:34:56Z"
                    },
                    "expiresAt": {
                        "description": "The timestamp when the token expires in ISO 8601 format",
                        "type": "string",
                        "format": "date-time",
                        "example": "2024-07-01T12:34:56Z"
                    }
                },
                "type": "object"
            },
            "TransportResource": {
                "title": "TransportResource",
                "required": [
                    "trip",
                    "hafasId",
                    "category",
                    "number",
                    "lineName",
                    "journeyNumber",
                    "distance",
                    "points",
                    "duration",
                    "manualDeparture",
                    "manualArrival",
                    "origin",
                    "destination",
                    "mode"
                ],
                "properties": {
                    "trip": {
                        "type": "integer",
                        "example": "4711"
                    },
                    "hafasId": {
                        "type": "string",
                        "example": "1|1234|567"
                    },
                    "category": {
                        "$ref": "#/components/schemas/HafasTravelType"
                    },
                    "mode": {
                        "oneOf": [
                            {
                                "$ref": "#/components/schemas/MotisCategory"
                            }
                        ],
                        "nullable": true
                    },
                    "number": {
                        "description": "Internal number of the journey",
                        "example": "4-a6s8-8"
                    },
                    "lineName": {
                        "type": "string",
                        "example": "S 1"
                    },
                    "routeColor": {
                        "description": "Hex color code of the route, if available",
                        "type": "string",
                        "example": "FFEE00",
                        "nullable": true
                    },
                    "routeTextColor": {
                        "description": "Hex color code of the route text, if available",
                        "type": "string",
                        "example": "FFFFFF",
                        "nullable": true
                    },
                    "journeyNumber": {
                        "type": "integer",
                        "example": 85639
                    },
                    "manualJourneyNumber": {
                        "description": "Manual journey number, if set by the user. This is intended for use cases like ICE lines in germany that have line number but are more widely known by their train number",
                        "type": "string",
                        "example": "ICE 4",
                        "nullable": true
                    },
                    "distance": {
                        "description": "Distance in meters",
                        "type": "integer",
                        "example": 10000
                    },
                    "points": {
                        "type": "integer",
                        "example": 37
                    },
                    "duration": {
                        "description": "Duration in minutes",
                        "type": "integer",
                        "example": 30
                    },
                    "manualDeparture": {
                        "type": "string",
                        "format": "date-time",
                        "example": "2022-07-17T13:37:00+02:00",
                        "nullable": true
                    },
                    "manualArrival": {
                        "type": "string",
                        "format": "date-time",
                        "example": "2022-07-17T13:37:00+02:00",
                        "nullable": true
                    },
                    "origin": {
                        "$ref": "#/components/schemas/StopoverResource"
                    },
                    "destination": {
                        "$ref": "#/components/schemas/StopoverResource"
                    },
                    "operator": {
                        "oneOf": [
                            {
                                "$ref": "#/components/schemas/OperatorResource"
                            }
                        ],
                        "nullable": true
                    },
                    "dataSource": {
                        "oneOf": [
                            {
                                "$ref": "#/components/schemas/DataSourceResource"
                            }
                        ],
                        "nullable": true
                    }
                },
                "type": "object"
            },
            "TripResource": {
                "title": "TripResource",
                "properties": {
                    "id": {
                        "type": "integer",
                        "example": 1
                    },
                    "category": {
                        "$ref": "#/components/schemas/HafasTravelType"
                    },
                    "mode": {
                        "oneOf": [
                            {
                                "$ref": "#/components/schemas/MotisCategory"
                            }
                        ],
                        "nullable": true
                    },
                    "number": {
                        "type": "string",
                        "example": "4-a6s4-4"
                    },
                    "lineName": {
                        "type": "string",
                        "example": "S 4"
                    },
                    "journeyNumber": {
                        "type": "integer",
                        "example": "34427"
                    },
                    "origin": {
                        "$ref": "#/components/schemas/Station"
                    },
                    "destination": {
                        "$ref": "#/components/schemas/Station"
                    },
                    "stopovers": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/StopoverResource"
                        }
                    },
                    "dataSource": {
                        "oneOf": [
                            {
                                "$ref": "#/components/schemas/DataSourceResource"
                            }
                        ],
                        "nullable": true
                    }
                },
                "type": "object"
            },
            "TrustedUserResource": {
                "title": "TrustedUser",
                "required": [
                    "user",
                    "expiresAt"
                ],
                "properties": {
                    "user": {
                        "$ref": "#/components/schemas/LightUserResource"
                    },
                    "expiresAt": {
                        "type": "string",
                        "format": "date-time",
                        "example": "2024-07-28T00:00:00Z",
                        "nullable": true
                    }
                },
                "type": "object"
            },
            "UserAuthResource": {
                "title": "UserAuth",
                "required": [
                    "id",
                    "displayName",
                    "username",
                    "profilePicture",
                    "totalDistance",
                    "totalDuration",
                    "points",
                    "mastodonUrl",
                    "privateProfile",
                    "preventIndex",
                    "likes_enabled",
                    "mapProvider",
                    "home",
                    "language",
                    "defaultStatusVisibility",
                    "roles"
                ],
                "properties": {
                    "id": {
                        "type": "integer",
                        "example": "1"
                    },
                    "displayName": {
                        "type": "string",
                        "example": "Gertrud"
                    },
                    "username": {
                        "type": "string",
                        "example": "Gertrud123"
                    },
                    "profilePicture": {
                        "type": "string",
                        "example": "https://traewelling.de/@Gertrud123/picture"
                    },
                    "totalDistance": {
                        "type": "integer",
                        "example": "100"
                    },
                    "totalDuration": {
                        "type": "integer",
                        "example": "100"
                    },
                    "points": {
                        "type": "integer",
                        "example": "100"
                    },
                    "mastodonUrl": {
                        "type": "string",
                        "example": "https://mastodon.social/@Gertrud123",
                        "nullable": true
                    },
                    "privateProfile": {
                        "type": "boolean",
                        "example": false
                    },
                    "preventIndex": {
                        "type": "boolean",
                        "example": false
                    },
                    "likes_enabled": {
                        "type": "boolean",
                        "example": true
                    },
                    "pointsEnabled": {
                        "type": "boolean",
                        "example": true
                    },
                    "mapProvider": {
                        "type": "string",
                        "example": "default"
                    },
                    "home": {
                        "$ref": "#/components/schemas/StationResource"
                    },
                    "language": {
                        "type": "string",
                        "example": "de"
                    },
                    "defaultStatusVisibility": {
                        "type": "integer",
                        "example": 0
                    },
                    "roles": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "example": [
                            "admin",
                            "open-beta",
                            "closed-beta"
                        ]
                    }
                },
                "type": "object"
            },
            "Notification": {
                "title": "Notification",
                "description": "Notification model",
                "properties": {
                    "id": {
                        "type": "string",
                        "example": "bb1ba9a5-9c2b-43c3-b8c9-2f70651fc51c"
                    },
                    "type": {
                        "type": "string",
                        "example": "UserJoinedConnection"
                    },
                    "leadFormatted": {
                        "type": "string",
                        "example": "<b>@bob</b> is in your connection!"
                    },
                    "lead": {
                        "type": "string",
                        "example": "@bob is in your connection!"
                    },
                    "noticeFormatted": {
                        "type": "string",
                        "example": "@bob is on <b>S 81</b> from <b>Karlsruhe Hbf</b> to <b>Freudenstadt Hbf</b>."
                    },
                    "notice": {
                        "type": "string",
                        "example": "@bob is on S 81 from Karlsruhe Hbf to Freudenstadt Hbf."
                    },
                    "link": {
                        "type": "string",
                        "example": "https://traewelling.de/status/123456"
                    },
                    "data": {
                        "type": "array",
                        "items": {}
                    },
                    "readAt": {
                        "type": "string",
                        "example": "2023-01-01T00:00:00+00:00",
                        "nullable": true
                    },
                    "createdAt": {
                        "type": "string",
                        "example": "2023-01-01T00:00:00+00:00"
                    },
                    "createdAtForHumans": {
                        "type": "string",
                        "example": "2 days ago"
                    }
                },
                "type": "object"
            },
            "UserProfileSettingsResource": {
                "title": "UserProfileSettings",
                "required": [
                    "username",
                    "displayName",
                    "profilePicture",
                    "privateProfile",
                    "preventIndex",
                    "defaultStatusVisibility",
                    "password",
                    "email",
                    "emailVerified",
                    "profilePictureSet",
                    "likesEnabled",
                    "pointsEnabled",
                    "profileLinks",
                    "mapProvider",
                    "timezone",
                    "experimental",
                    "friendCheckin",
                    "mastodon",
                    "mastodonVisibility",
                    "bio"
                ],
                "properties": {
                    "username": {
                        "type": "string",
                        "example": "Gertrud123"
                    },
                    "displayName": {
                        "type": "string",
                        "example": "Gertrud"
                    },
                    "profilePicture": {
                        "type": "string",
                        "example": "https://traewelling.de/@Gertrud123/picture"
                    },
                    "privateProfile": {
                        "type": "boolean",
                        "example": false
                    },
                    "preventIndex": {
                        "description": "Did the user choose to prevent search engines from indexing their profile?",
                        "type": "boolean",
                        "example": false
                    },
                    "defaultStatusVisibility": {
                        "$ref": "#/components/schemas/StatusVisibility"
                    },
                    "privacyHideDays": {
                        "description": "Number of days to hide the user's location history. Null if disabled.",
                        "type": "integer",
                        "example": 1,
                        "nullable": true
                    },
                    "password": {
                        "type": "boolean",
                        "example": true
                    },
                    "email": {
                        "type": "string",
                        "example": "gertrud@traewelling.de"
                    },
                    "emailVerified": {
                        "type": "boolean",
                        "example": true
                    },
                    "profilePictureSet": {
                        "type": "boolean",
                        "example": true
                    },
                    "mastodon": {
                        "type": "string",
                        "example": "https://mastodon.social/@Gertrud123"
                    },
                    "mastodonVisibility": {
                        "$ref": "#/components/schemas/MastodonVisibility"
                    },
                    "friendCheckin": {
                        "$ref": "#/components/schemas/FriendCheckinSetting"
                    },
                    "likesEnabled": {
                        "type": "boolean",
                        "example": true
                    },
                    "pointsEnabled": {
                        "type": "boolean",
                        "example": true
                    },
                    "mapProvider": {
                        "$ref": "#/components/schemas/MapProvider"
                    },
                    "timezone": {
                        "type": "string",
                        "example": "Europe/Berlin"
                    },
                    "bio": {
                        "type": "string",
                        "example": "Hi there! I am Gertrud!"
                    },
                    "profileLinks": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/ProfileLinkResource"
                        }
                    },
                    "experimental": {
                        "description": "Experimental features enabled",
                        "type": "boolean",
                        "example": false
                    }
                },
                "type": "object"
            },
            "UserResource": {
                "title": "User",
                "description": "User model",
                "required": [
                    "id",
                    "displayName",
                    "username",
                    "profilePicture",
                    "totalDistance",
                    "totalDuration",
                    "points",
                    "mastodonUrl",
                    "privateProfile",
                    "pointsEnabled",
                    "userInvisibleToMe",
                    "muted",
                    "blocked",
                    "following",
                    "followPending",
                    "followedBy",
                    "preventIndex",
                    "bio",
                    "profileLinks"
                ],
                "properties": {
                    "id": {
                        "description": "ID",
                        "type": "integer",
                        "example": 1
                    },
                    "displayName": {
                        "description": "Display name of the user",
                        "example": "Gertrud"
                    },
                    "username": {
                        "description": "username of user",
                        "example": "Gertrud123"
                    },
                    "profilePicture": {
                        "description": "URL of the profile picture of the user",
                        "example": "https://traewelling.de/@Gertrud123/picture"
                    },
                    "totalDistance": {
                        "description": "distance travelled in meters",
                        "type": "integer",
                        "example": 12345
                    },
                    "totalDuration": {
                        "description": "duration travelled in minutes",
                        "type": "integer",
                        "example": 6
                    },
                    "points": {
                        "description": "Current points of the last 7 days",
                        "type": "integer",
                        "example": 300
                    },
                    "mastodonUrl": {
                        "description": "URL to the Mastodon profile of the user",
                        "example": "https://chaos.social/@traewelling",
                        "nullable": true
                    },
                    "privateProfile": {
                        "description": "is this profile set to private?",
                        "type": "boolean",
                        "example": false
                    },
                    "points_enabled": {
                        "description": "Does this profile allow points? Only offer the UI to show points at any status if this setting is set to true. If set to false, the points will always be displayed as 0",
                        "type": "boolean",
                        "example": true
                    },
                    "likes_enabled": {
                        "description": "Does this profile allow likes? Only offer the UI to like any status if this setting is set to true. If set to false, the likes API will return 403.",
                        "type": "boolean",
                        "example": true
                    },
                    "pointsEnabled": {
                        "description": "Does this profile allow points? Only offer the UI to show points at any status if this setting is set to true. If set to false, the points will always be displayed as 0",
                        "type": "boolean",
                        "example": true
                    },
                    "userInvisibleToMe": {
                        "description": "Can the currently authenticated user see the statuses of this user?",
                        "type": "boolean",
                        "example": false
                    },
                    "muted": {
                        "description": "Is this user muted by the currently authenticated user?",
                        "type": "boolean",
                        "example": false
                    },
                    "blocked": {
                        "description": "Is this user blocked by the currently authenticated user?",
                        "type": "boolean",
                        "example": false
                    },
                    "following": {
                        "description": "Does the currently authenticated user follow this user?",
                        "type": "boolean",
                        "example": false
                    },
                    "followPending": {
                        "description": "Is there a currently pending follow request?",
                        "type": "boolean",
                        "example": false
                    },
                    "followedBy": {
                        "description": "Is the user following you?",
                        "type": "boolean",
                        "example": false
                    },
                    "preventIndex": {
                        "description": "Did the user choose to prevent search engines from indexing their profile?",
                        "type": "boolean",
                        "example": false
                    },
                    "bio": {
                        "description": "Bio of the user",
                        "type": "string",
                        "example": "Hi there! I am Gertrud!"
                    },
                    "profileLinks": {
                        "description": "Profile links of the user",
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/ProfileLinkResource"
                        }
                    }
                },
                "type": "object"
            },
            "WebhookEventResource": {
                "title": "WebhookEventResource",
                "description": "WebhookEvent model",
                "required": [
                    "type"
                ],
                "properties": {
                    "type": {
                        "description": "The type of the event",
                        "example": "notification"
                    }
                },
                "type": "object"
            },
            "WebhookResource": {
                "title": "WebhookResource",
                "description": "Webhook model",
                "required": [
                    "id",
                    "clientId",
                    "client",
                    "userId",
                    "user",
                    "url",
                    "createdAt",
                    "events"
                ],
                "properties": {
                    "id": {
                        "description": "ID",
                        "format": "int",
                        "example": 12345
                    },
                    "client": {
                        "$ref": "#/components/schemas/ClientResource"
                    },
                    "clientId": {
                        "description": "Deprecated. Use client.id instead.",
                        "format": "int",
                        "example": 12345,
                        "deprecated": true
                    },
                    "user": {
                        "$ref": "#/components/schemas/LightUserResource"
                    },
                    "userId": {
                        "description": "Deprecated. Use user.id instead.",
                        "format": "int",
                        "example": 12345,
                        "deprecated": true
                    },
                    "url": {
                        "description": "URL where the webhook gets sent to",
                        "example": "https://example.com/webhook"
                    },
                    "createdAt": {
                        "description": "The ISO 8601 timestamp when the webhook was created",
                        "type": "string",
                        "format": "date-time",
                        "example": "2024-01-01T12:00:00Z"
                    },
                    "events": {
                        "description": "List of events which are triggered for this webhook",
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/WebhookEventResource"
                        }
                    }
                },
                "type": "object"
            }
        },
        "securitySchemes": {
            "passport": {
                "type": "oauth2",
                "description": "OAuth2 authorizationCode Flow. Get your token from https://traewelling.de/settings/applications. Set the redirect URL to https://traewelling.de/api/oauth2-callback to use it here. See also https://laravel.com/docs/9.x/passport",
                "in": "header",
                "scheme": "https",
                "flows": {
                    "authorizationCode": {
                        "authorizationUrl": "http://localhost:8000/oauth/authorize",
                        "tokenUrl": "http://localhost:8000/oauth/token",
                        "refreshUrl": "http://localhost:8000/auth/refresh",
                        "scopes": {
                            "read-statuses": "see all statuses",
                            "read-notifications": "see your notifications",
                            "read-statistics": "see your statistics",
                            "read-search": "search in Träwelling",
                            "write-statuses": "create, edit, delete statuses",
                            "write-likes": "create and remove likes",
                            "write-notifications": "mark notifications as read, clear notifications",
                            "write-exports": "request data exports",
                            "write-follows": "follow and unfollow users",
                            "write-followers": "accept follow requests and remove followers",
                            "write-blocks": "block and unblock users, mute and unmute users",
                            "write-event-suggestions": "suggest events in your name",
                            "write-support-tickets": "create support tickets in your name",
                            "read-settings": "see your settings, email, etc.",
                            "write-settings-profile": "edit your profile",
                            "read-settings-profile": "see your profile data, e.g. email",
                            "write-settings-mail": "edit your email",
                            "write-settings-profile-picture": "edit your profile picture",
                            "write-settings-privacy": "change your privacy settings",
                            "read-settings-followers": "show follow-requests and followers",
                            "write-settings-calendar": "create and delete new calendar-tokens",
                            "extra-write-password": "change your password",
                            "extra-terminate-sessions": "log you out of other sessions and apps",
                            "extra-delete": "delete your account"
                        }
                    }
                }
            },
            "token": {
                "type": "apiKey",
                "description": "Enter token in format \"Bearer \\<token\\>\". You can create your personal access token at https://traewelling.de/settings/applications. We recommend this method for prototyping purposes. For all other use cases please use the oAuth method above.",
                "name": "Authorization",
                "in": "header"
            }
        }
    },
    "tags": [
        {
            "name": "Community",
            "description": "Community contribution system endpoints"
        },
        {
            "name": "Configuration Information",
            "description": "Endpoints related to application configuration information."
        },
        {
            "name": "Auth",
            "description": "Logging in, creating Accounts, etc."
        },
        {
            "name": "Checkin",
            "description": "Checkin related endpoints. Regular process is departures -> trip -> checkin"
        },
        {
            "name": "Dashboard",
            "description": "API Endpoints of Dashboard"
        },
        {
            "name": "Events",
            "description": "Events that users can check in to"
        },
        {
            "name": "Notifications",
            "description": "Get notifications and mark them as read or unread"
        },
        {
            "name": "Status",
            "description": "Endpoints for accessing and manipulating Statusses and their additional data"
        },
        {
            "name": "Likes",
            "description": "Likes regarding a single status"
        },
        {
            "name": "User",
            "description": "Information regarding users"
        },
        {
            "name": "User/Follow",
            "description": "Follow and unfollow users, manage your followers"
        },
        {
            "name": "User/Hide and Block",
            "description": "Mute and block users"
        },
        {
            "name": "Leaderboard",
            "description": "Leaderboard related endpoints"
        },
        {
            "name": "Statistics",
            "description": "Statistics related endpoints"
        },
        {
            "name": "ICS Tokens",
            "description": "Manage ICS Tokens for calendar export"
        },
        {
            "name": "Settings",
            "description": "User/Profile-Settings"
        },
        {
            "name": "Webhooks",
            "description": "Manage Webhooks for third party applications"
        },
        {
            "name": "Report",
            "description": "Report a Status, Event or User to the admins"
        },
        {
            "name": "Security",
            "description": "Security"
        },
        {
            "name": "Trips",
            "description": "Trips"
        }
    ]
}