List medical fee services

Returns a paginated list of all medical fee services of the company.

Request

GET /api/oauth/v2/resource/fee-note-services

Header

Header	Value
Authorization	Bearer {access_token}

Query parameters

Parameter	Type	Required	Description
from	string	No	Start of the period, ISO date or timestamp. Filters by date, or by createdAt for rows without a date
until	string	No	End of the period, ISO date or timestamp. A date-only value includes the whole day up to 23:59:59
billStatus	string	No	Comma-separated list of open, invoiced, ignore, unknown
treatingUserId	string (UUID)	No	Filters by treating user
customerId	string (UUID)	No	Filters by customer. Additionally requires the customers scope
offset	integer	No	Start position (default: 0)
limit	integer	No	Number of results (default: 50, max: 200)

The default order is date descending, then id descending. meta.total counts only the rows you are allowed to see.

Response

Success (200 OK)

{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Erstkonsultation",
      "internalNumber": "01",
      "description": "Erste ärztliche Untersuchung inkl. Anamnese",
      "diagnose": "Z00.0",
      "date": "2026-06-08",
      "quantity": 1.0,
      "gross": 120.00,
      "net": 100.00,
      "netPerUnit": 100.00,
      "unit": "Einheit",
      "billStatus": "open",
      "customer": {
        "id": "f0e1d2c3-b4a5-6789-fedc-ba9876543210",
        "firstName": "Anna",
        "lastName": "Muster"
      },
      "treatingUser": "6f1c1a2b-3c4d-5e6f-7890-abcdef123456",
      "insuranceService": "3a8b1c2d-3e4f-5061-7283-94a5b6c7d8e9",
      "appointment": "c4d5e6f7-a8b9-4c0d-8e1f-2a3b4c5d6e7f",
      "resource": "7c2f5b81-40de-4a19-b6c3-8ea1d0742f95"
    },
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "name": "Blutabnahme",
      "internalNumber": "02",
      "description": null,
      "diagnose": null,
      "date": "2026-06-08",
      "quantity": 1.0,
      "gross": 25.00,
      "net": 20.83,
      "netPerUnit": 20.83,
      "unit": null,
      "billStatus": "invoiced",
      "customer": {
        "id": "f0e1d2c3-b4a5-6789-fedc-ba9876543210",
        "firstName": "Anna",
        "lastName": "Muster"
      },
      "treatingUser": "6f1c1a2b-3c4d-5e6f-7890-abcdef123456",
      "insuranceService": "3a8b1c2d-3e4f-5061-7283-94a5b6c7d8e9",
      "appointment": "c4d5e6f7-a8b9-4c0d-8e1f-2a3b4c5d6e7f",
      "resource": "7c2f5b81-40de-4a19-b6c3-8ea1d0742f95"
    }
  ],
  "meta": {
    "total": 84,
    "offset": 0,
    "limit": 50
  }
}

Response fields

Field	Type	Description
data	Array	List of medical fee services
data[].id	string (UUID)	Unique ID of the medical fee service
data[].name	string	Name of the service
data[].internalNumber	string | null	Internal service number
data[].description	string | null	Description of the service
data[].diagnose	string | null	Diagnosis (e.g. ICD code)
data[].date	string | null	Service date (YYYY-MM-DD)
data[].quantity	float	Number of units
data[].gross	float	Gross amount
data[].net	float	Net amount total
data[].netPerUnit	float	Net amount per unit
data[].unit	string | null	Unit (e.g. "unit", "hour")
data[].billStatus	string	Billing status: open, invoiced, ignore, unknown
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
data[].treatingUser	string (UUID) | null	Treating user. Retrieve via Get user. null if not set
data[].insuranceService	string (UUID) | null	ID of the service. No OAuth endpoint to retrieve it, see Conventions. null if not set
data[].appointment	string (UUID) | null	Associated appointment. Get start and end times and the course via Get appointment. null if not set
data[].resource	string (UUID) | null	Resource of the appointment. No OAuth endpoint to retrieve it. null if not set
meta.total	integer	Total number of medical fee services
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/fee-note-services?from=beispiel&until=beispiel&billStatus=beispiel&treatingUserId=b2c3d4e5-f6a7-8901-bcde-f01234567890&customerId=b2c3d4e5-f6a7-8901-bcde-f01234567890&offset=0&limit=50" \
  -H "Authorization: Bearer {access_token}"

Server

Client-ID

Client-Secret

Parameter

from string

until string

billStatus string

treatingUserId string

customerId string

offset integer

limit integer

Zuerst Token anfordern

Possible errors

Status	Code	Description
400	validation_error	from or until is not a valid ISO date or timestamp
400	validation_error	Invalid billStatus. Allowed values are open, invoiced, ignore, unknown
400	validation_error	treatingUserId or customerId is not a valid UUID
401	invalid_client	Invalid or missing access token
403	insufficient_scope	Scope medicals not present
403	insufficient_scope	customerId is set but scope customers is missing (error_description: Filtering by customerId requires the "customers" scope.)
404	not_found	treatingUserId (User not found) or customerId (Customer not found) does not match an existing record