List service jobs

Soft-deleted service jobs are currently still listed (missing deleted_at filter in the shared service job view — known issue).

GET/service-job

Authorization

AuthorizationAPI key · headerrequired

The Incoming Secret value (<secretId>.<random>), with or without a Bearer prefix.

Query parameters

machineIdstring

Filter by machine id.

stateNamestring

Filter by the current state name, e.g. "Scheduled".

createdAtstring

Filter by creation date — a single ISO date (from that date to now) or a range via createdAt[from] / createdAt[to].

Responses

200

OK.

Array of ServiceJob

idstring

Service job id (read-only, autoassigned)

appIdstring

App id (read-only, autoassigned)

serviceJobSidstring

Autogenerated user-friendly id of the service job (read-only, autoassigned)

namestring

Service job name

statusNamestring

Service job status name

stateNamestring

Current service job state name, e.g. "Scheduled" — derived from dev01.public.service_job_state.name (read-only). Filterable in list, e.g. ?stateName=Scheduled.

scheduleStartstring

Scheduled start (ISO date)

scheduleEndstring

Scheduled end (ISO date)

durationnumber

Duration in minutes

zHeightnumber

Z height of the service job

materialConsumptionnumber

Material consumption

machineIdstring

Machine id

materialIdstring

Material id (create-only)

ticketModelsobject

Map of ticketModelId to quantity (update-only)

machineConfigurationNamestring

Machine configuration name (create-only)

materialBatchstring

Material batch (read-only)

serviceJobNotesstring

Service job notes (read-only)

nestedServiceJobUrlsobject

Map of fileName to {url, headers} for nested service job files (update-only)

slicedServiceJobUrlsobject

Map of fileName to {url, headers} for sliced service job files (update-only)

nestedServiceJobUrlstring

Link to archived nested service job files (read-only)

slicedServiceJobUrlstring

Link to archived sliced service job files (read-only)

createdAtstring

Creation timestamp (ISO date, read-only, autoassigned)

shipping_deadlinestring

Shipping deadline (ISO date)

thumbnailUrlstring

Thumbnail link (read-only)

additional_filesobject

Additional files

production_notesobject

Production notes

401

Authentication failed. All causes return this identical response.

codeinteger

messagestring

typestring

default

Downstream errors pass through verbatim; x-error-source names the failing service.

codeinteger

messagestring

typestring

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

API keyRemember on this deviceInclude my values in samples

Parameters

machineIdqueryFilter by machine id.stateNamequeryFilter by the current state name, e.g. "Scheduled".createdAtqueryFilter by creation date — a single ISO date (from that date to now) or a range via createdAt[from] / createdAt[to].

Request

curl -X GET 'https://next.amfg.ai/engine-service/public-api/v1/service-job' \
  -H 'Authorization: YOUR_API_KEY'

const response = await fetch("https://next.amfg.ai/engine-service/public-api/v1/service-job", {
  method: "GET",
  headers: {
    "Authorization": "YOUR_API_KEY"
  }
});

import requests

response = requests.get(
    "https://next.amfg.ai/engine-service/public-api/v1/service-job",
    headers={
        "Authorization": "YOUR_API_KEY"
    },
)

Response

[
  {
    "id": "232",
    "appId": "1677",
    "serviceJobSid": "X-147-BUILD-95000",
    "name": "X-147-BUILD-95000",
    "statusName": "In preparation",
    "stateName": "Scheduled",
    "scheduleStart": "2021-09-23T08:51:00.000Z",
    "scheduleEnd": "2021-09-23T08:55:00.000Z",
    "duration": 4,
    "materialId": "384",
    "machineId": "164",
    "nestedServiceJobUrl": "https://...",
    "slicedServiceJobUrl": "https://...",
    "createdAt": "2022-07-01T08:01:47.575Z"
  }
]

{
  "code": 401,
  "message": "Not Authorized"
}

{
  "code": 0,
  "message": "string",
  "type": "string"
}