MyZSK API

The MyZSK API is a read-only REST interface that allows for the retrieval of embroidery data, machine statuses, and analytics from the MyZSK platform. It is designed for the programmatic analysis of production, thread breaks, shifts, and operators.

List machines for a datacollector

GET /datacollectors/{id}/machines

Returns all visible machines connected to a specific datacollector (Poolbox unit). The datacollector must belong to the authenticated company.

Authentication

Requires the X-API-Key header.

Path parameters

id (string, required) – the datacollector identifier (e.g. POOL-001).

Response (200 OK)

FieldTypeDescription
data[].machine_idstringUnique machine identifier (e.g. 26027).
data[].machine_namestringMachine display name / alias.
data[].location_namestringName of the location the machine is assigned to.
data[].headsintegerNumber of embroidery heads.
data[].needlesintegerNumber of needles per head.
data[].first_seenstring (date-time)First time this machine reported via this datacollector.
data[].last_seenstring (date-time)Last time the machine reported in.

Parameters

Parameter Type Description Required
id string (path) Datacollector identifier (Poolbox unit ID). Yes

Example

curl -H "X-API-Key: $MYZSK_API_KEY" \
     "https://my.zsk.de/customer-api/datacollectors/POOL-001/machines"