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
view	string	No	default (default value) or slim for the slim response

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.

Slim response (?view=slim)

With ?view=slim, the endpoint returns only the most important fields per service assignment. Without the parameter, the response stays unchanged — existing integrations don't need to change anything.

If view is given more than once, the last value wins — ?view=default&view=slim returns the slim response.

The slim response shrinks user, location, and service from full objects to an object with only id each. The field count stays at 4, but the key count drops from 14 to 4 per record.

{
  "data": [
    {
      "id": "42",
      "user": {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
      },
      "location": {
        "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901"
      },
      "service": {
        "id": "c3d4e5f6-a7b8-9012-cdef-012345678901"
      }
    }
  ],
  "meta": {
    "total": 5,
    "offset": 0,
    "limit": 50
  }
}

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&view=default" \
  -H "Authorization: Bearer {access_token}"

Server

Client-ID

Client-Secret

Parameter

offset integer

limit integer

locationId string

userId string

view string

Zuerst Token anfordern

Possible errors

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