List visit confirmations
Returns a paginated list of all visit confirmations of the company.
Request
GET /api/oauth/v2/resource/visit-confirmations
Header
| Header | Value |
|---|---|
Authorization | Bearer {access_token} |
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
offset | integer | No | Start position (default: 0, min: 0) |
limit | integer | No | Number of results (default: 50, min: 1, max: 200) |
Response
Success (200 OK)
json
{
"data": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"customDate": "2026-06-09",
"customStart": "09:00",
"customEnd": "09:30",
"printTime": true,
"printed": false,
"customer": {
"id": "f0e1d2c3-b4a5-6789-fedc-ba9876543210",
"firstName": "Anna",
"lastName": "Muster"
}
},
{
"id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"customDate": "2026-06-08",
"customStart": null,
"customEnd": null,
"printTime": false,
"printed": true,
"customer": {
"id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"firstName": "Thomas",
"lastName": "Gruber"
}
}
],
"meta": {
"total": 18,
"offset": 0,
"limit": 50
}
}Response fields
| Field | Type | Description |
|---|---|---|
data | Array | List of visit confirmations |
data[].id | string (UUID) | Unique ID of the visit confirmation |
data[].customDate | string | null | Date of the visit (YYYY-MM-DD) |
data[].customStart | string | null | Start time of the visit (HH:MM) |
data[].customEnd | string | null | End time of the visit (HH:MM) |
data[].printTime | boolean | null | Print time on the confirmation |
data[].printed | boolean | null | Confirmation has already been printed |
data[].customer | object | null | Assigned customer |
data[].customer.id | string (UUID) | Customer ID |
data[].customer.firstName | string | Customer first name |
data[].customer.lastName | string | Customer last name |
meta.total | integer | Total number of visit confirmations |
meta.offset | integer | Current start position |
meta.limit | integer | Number of returned entries |
Beispiele
bash
curl -X GET "https://my.offisy.at/api/oauth/v2/resource/visit-confirmations?offset=0&limit=50" \
-H "Authorization: Bearer {access_token}"Parameter
Zuerst Token anfordern
Possible errors
| Status | Code | Description |
|---|---|---|
| 401 | invalid_client | Invalid or missing access token |
| 403 | insufficient_scope | Scope medicals not present |