Skip to content
Download OpenAPI description
Languages
Servers
Mock server

https://docs.zimark.link/_mock/api/

https://{organizationSubdomain}.zimark-staging.link/

https://{organizationSubdomain}.zimark.link/

Zimarker

Allocate zimarker code(s) on demand for the calling organization, each with a printable, inline base64 marker image. Allocation is synchronous, atomic, and exactly-once per organization.

Render a zimarker code's marker image on demand. Public, stateless, and addressable by code at a stable URL — no authentication required.

Operations

Manifest

API endpoints for managing manifests and their associated assets/tracks.

A manifest is a container that groups assets/pallets for tracking purposes.

Operations

Shipment

API endpoints for managing shipments (multi-manifest dispatch grouping). A shipment groups one or more manifests for dispatch at a single gate; only available to organizations configured with the shipment dispatch strategy.

Operations

List assets (tracks) across all manifests in the shipment

Request

Returns a flattened list of track records spanning every non-cancelled manifest attached to the shipment. Each entry includes the track, its loading status, and the owning manifest reference.

Security
X-AUTH-KEY
Path
shipmentExternalIdstringrequired

Shipment external identifier or uuid.

Example: SHIP-2024-001
curl -i -X GET \
  https://docs.zimark.link/_mock/api/integration/rest/api/v1/shipment/SHIP-2024-001/asset \
  -H 'X-AUTH-KEY: YOUR_API_KEY_HERE'

Responses

OK

Body*/*Array [
trackIdentifierstring

Track identifier (WMS id).

trackobject(TrackV1Dto)

Track details.

loadingStatusstring

Current loading status of the asset at the gate.

Enum"NOT_LOADED""LOADED""WRONGLY_LOADED""UNKNOWN_LOADING""UNLOADED""OFFLOADED"
manifestobject(ShipmentManifestRefV1Dto)

The manifest this track belongs to within the shipment.

]

Get shipment asset loading details

Request

Retrieves asset-loading records for every track dispatched under the shipment, including manifest-linked rows (LOADED, NOT_LOADED, UNLOADED, OFFLOADED) and dispatched/unauthorized rows (WRONGLY_LOADED, UNKNOWN_LOADING). Each record carries the recordUuid required by the shipment DELETE asset-loading endpoints.

Security
X-AUTH-KEY
Path
shipmentExternalIdstringrequired

Shipment external identifier (preferred) or uuid.

Example: SHIP-2024-001
curl -i -X GET \
  https://docs.zimark.link/_mock/api/integration/rest/api/v1/shipment/SHIP-2024-001/asset-loading \
  -H 'X-AUTH-KEY: YOUR_API_KEY_HERE'

Responses

OK

Body*/*Array [
createDatestring(date-time)
updateDatestring(date-time)
deepLinkstring

Deep link URL to open this entity in Ops.App.

trackobject(ManifestTrackV1Dto)

Track associated with this loading record.

gateobject(GateV1Dto)

Gate where the loading action was performed.

trackIdentifierstring

Business identifier of the track linked to this record.

markerValuestring

Marker value captured during the loading operation.

loadedDatestring(date-time)

Date and time when the asset was marked as loaded.

loadingStatusstring

Current loading status of the asset.

Enum"NOT_LOADED""LOADED""WRONGLY_LOADED""UNKNOWN_LOADING""UNLOADED""OFFLOADED"
]

Request

Removes a specific custom field from a shipment by its key. The field and its value will be permanently deleted from the shipment.

Security
X-AUTH-KEY
Path
shipmentExternalIdstringrequired

Shipment external identifier or uuid.

Example: SHIP-2024-001
fieldKeystringrequired

Key of the custom field to delete.

Example: CARRIER
curl -i -X DELETE \
  https://docs.zimark.link/_mock/api/integration/rest/api/v1/shipment/SHIP-2024-001/custom-field/CARRIER \
  -H 'X-AUTH-KEY: YOUR_API_KEY_HERE'

Responses

No content

Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations

Calibration Integration

External API for integration systems with token-based authentication

Operations
Operations