List Service Assignments

Returns a paginated list of all active service assignments.

Request

GET /api/oauth/v2/resource/executions

Header

Header	Value
Authorization	Bearer {access_token}

Query parameters

Parameter	Type	Required	Description
offset	integer	No	Start position (default: 0)
limit	integer	No	Number of results (default: 50, max: 200)
locationId	string (UUID)	No	Only assignments for a specific location
userId	string (UUID)	No	Only assignments for a specific user

Required scope: executions

Response

Success (200 OK)

{
  "data": [
    {
      "id": "42",
      "user": {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "firstName": "Maria",
        "lastName": "Mustermann",
        "abbreviation": "MM"
      },
      "location": {
        "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "name": "Wien Mariahilfer"
      },
      "service": {
        "id": "c3d4e5f6-a7b8-9012-cdef-012345678901",
        "name": "Erstordination",
        "duration": 60,
        "price": 120.00
      }
    }
  ],
  "meta": {
    "total": 5,
    "offset": 0,
    "limit": 50
  }
}

Response fields

Field	Type	Description
data	Array	List of service assignments
data[].id	string	Unique ID of the service assignment (integer, not a UUID)
data[].user	object	Assigned user
data[].user.id	string (UUID)	Unique user ID
data[].user.firstName	string	First name of the user
data[].user.lastName	string	Last name of the user
data[].user.abbreviation	string	Abbreviation of the user
data[].location	object	Assigned location
data[].location.id	string (UUID)	Unique location ID
data[].location.name	string	Name of the location
data[].service	object	Assigned service
data[].service.id	string (UUID)	Unique service ID
data[].service.name	string	Name of the service
data[].service.duration	integer	Appointment duration in minutes
data[].service.price	number | null	Price (gross)
meta.total	integer	Total number of service assignments
meta.offset	integer	Current start position
meta.limit	integer	Number of returned results

Note: data[].id is an integer ID as a string — not a UUID like other endpoints.

Beispiele

bash

curl -X GET "https://my.offisy.at/api/oauth/v2/resource/executions?offset=0&limit=50&locationId=b2c3d4e5-f6a7-8901-bcde-f01234567890&userId=b2c3d4e5-f6a7-8901-bcde-f01234567890" \
  -H "Authorization: Bearer {access_token}"

Server

Client-ID

Client-Secret

Parameter

offset integer

limit integer

locationId string

userId string

Zuerst Token anfordern

Possible errors

Status	Code	Description
401	invalid_client	Invalid or missing access token
403	insufficient_scope	Scope executions not present
400	invalid_request	Invalid locationId or userId
404	not_found	Location or user not found