GET /api/account/service-order-appointments

get/api/account/service-order-appointments

Beispielanfrage

GET https://api.jupiter-erp.com/api/account/service-order-appointments

Code

curl -X GET 'https://api.jupiter-erp.com/api/account/service-order-appointments' \
  -H 'Authorization: Bearer YOUR_API_TOKEN' \
  -H 'X-Account-Uuid: YOUR_ACCOUNT_UUID' \
  -H 'Accept: application/json'

Parameter

Name	In	Pflicht	Beschreibung
service_order_id	query	nein	Filter by service order.
contact_id	query	nein	Filter by contact (via linked service order).
project_id	query	nein	Filter by project (via linked service order).
service_contract_id	query	nein	Filter by service contract (via linked service order).
status	query	nein	—
assignee_account_user_id	query	nein	—
starts_from	query	nein	Filter appointments with starts_at on or after this date (Y-m-d).
starts_to	query	nein	Filter appointments with starts_at on or before this date (Y-m-d).
order_by	query	nein	—
#/components/parameters/OrderDirParameter
#/components/parameters/PerPageParameter
#/components/parameters/PageParameter

Antworten

200OK

ModellListServiceOrderAppointments200Response

Feld

Typ

Beschreibung

data*

object[]

array

Elemente

Scheduled dispatch / visit window for a service order (Gantt bar source)

Feld

Typ

Beschreibung

assignee

object

Feld

Typ

Beschreibung

abilities

string[]

Ability strings for this account user. Included when listing or getting users (admin editing). Omitted in embedded contexts (e.g. documents, projects, service orders) to avoid leaking permission data.

array

Elemente

string

created_at

string (date-time)

Creation timestamp in ISO 8601 format.

display_email

string

—

display_name

string

—

display_phone

string

—

id*

integer

—

invited_email

string

Email address the user was invited with. Set for pending account users; null after acceptance or when not applicable.

role*

string

user
admin

status*

string

active
blocked
pending

updated_at

string (date-time)

Last update timestamp in ISO 8601 format.

user

object

Feld	Typ	Beschreibung
email*	string	—
id*	integer	—
image_url	string	—
name*	string	—

assignee_account_user_id

integer

—

created_at

string (date-time)

Creation timestamp in ISO 8601 format.

ends_at*

string

Local datetime without timezone (Y-m-dTH:i:s)

id*

integer

—

service_order*

object

Parent order summary; always present when returned from the API.

Feld	Typ	Beschreibung
contact_name	string	Contact display name for scheduling views without loading full contact
formatted_number*	string	—
id*	integer	—
service_location	string	—
status*	string	string open planned in_progress done invoiced cancelled
subject	string	—

service_order_id*

integer

—

starts_at*

string

Local datetime without timezone (Y-m-dTH:i:s)

status*

string

planned
confirmed
completed
cancelled

updated_at

string (date-time)

Last update timestamp in ISO 8601 format.

meta*

object

Feld	Typ	Beschreibung
current_page*	integer	The current page number.
items_from*	integer	The starting item number on the current page.
items_to*	integer	The ending item number on the current page.
last_page*	integer	The last page number.
per_page*	integer	The number of items per page.
total*	integer	The total number of items.

Beispiel Response

{
  "data": [
    {
      "id": 0,
      "service_order_id": 0,
      "service_order": {
        "id": 0,
        "formatted_number": "string",
        "subject": "string",
        "service_location": "string",
        "contact_name": "string",
        "status": "open"
      },
      "starts_at": "2025-01-14T09:00:00",
      "ends_at": "2025-01-14T17:00:00",
      "assignee_account_user_id": 0,
      "status": "planned"
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 1,
    "per_page": 15,
    "total": 1,
    "items_from": 1,
    "items_to": 1
  }
}

Service order appointments

Fragen zur Integration?