Skip to content
/
List shipments (paginated...

Zimark Integration API (v0)

Download OpenAPI description
api.json
api.yaml
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

Soft-delete a shipment

Request

Allowed from any non-terminal state including IN_PROGRESS. Detaches all manifests and releases the external identifier for reuse.

Security
X-AUTH-KEY
Path
shipmentExternalIdstringrequired

Shipment external identifier or uuid.

curl -i -X DELETE \
  'https://docs.zimark.link/_mock/api/integration/rest/api/v1/shipment/{shipmentExternalId}' \
  -H 'X-AUTH-KEY: YOUR_API_KEY_HERE'

Responses

No content

List shipments (paginated, filterable)

Request

Returns a paginated list of shipments for the authenticated caller's organization. Supports filtering by status (multi-valued), gate (by UUID or external id), free-text, and three independent date ranges (created, activated, closed). Null-date semantics: when any bound is supplied on activateDate or closeDate, shipments whose corresponding date field is null are excluded.

Security
X-AUTH-KEY
Query
statusesArray of strings

Filter by shipment status (multi-valued).

Items Enum"PLANNED""TO_DO""IN_PROGRESS""COMPLETED""CANCELLED"
gatestring

Filter by gate identifier (accepts external id or uuid).

activateDateAfterinteger(int64)

Activated-date range lower bound (epoch millis, inclusive). Shipments with null activateDate are excluded when any bound is supplied.

activateDateBeforeinteger(int64)

Activated-date range upper bound (epoch millis, inclusive).

closeDateAfterinteger(int64)

Closed-date range lower bound (epoch millis, inclusive). Shipments with null closeDate are excluded when any bound is supplied.

closeDateBeforeinteger(int64)

Closed-date range upper bound (epoch millis, inclusive).

qstring
createDateAfterinteger(int64)
createDateBeforeinteger(int64)
pageNumberinteger(int32)

Page number (1-based)

pageSizeinteger(int32)<= 100

Page size

sort.sortBystring

Sorting field

sort.directionstring

Sorting direction

Enum"ASC""DESC"
curl -i -X GET \
  'https://docs.zimark.link/_mock/api/integration/rest/api/v1/shipment?statuses=PLANNED&gate=string&activateDateAfter=0&activateDateBefore=0&closeDateAfter=0&closeDateBefore=0&q=string&createDateAfter=0&createDateBefore=0&pageNumber=0&pageSize=100&sort.sortBy=string&sort.direction=ASC' \
  -H 'X-AUTH-KEY: YOUR_API_KEY_HERE'

Responses

OK

Body*/*
contentArray of objects(ShipmentV1Dto)
pageRequestobject(PageRequest)
totalElementsinteger(int32)

Create shipment

Request

Creates a new shipment in status TO_DO. Optional external identifier, optional gate (by external id or uuid), optional notes, optional manifest list. Returns the full shipment payload.

Security
X-AUTH-KEY
Bodyapplication/jsonrequired
identifierstring[ 0 .. 255 ] charactersrequired

Required. Caller-assigned shipment external identifier, unique per organization within the Shipment namespace. May collide with Manifest external identifiers (independent namespaces).

gateIdentifierstring[ 0 .. 255 ] characters

Gate to attach at create time. Accepts the gate external identifier OR internal UUID.

notesstring[ 0 .. 1000 ] characters

Free-text notes attached to the shipment.

manifestsArray of objects(ManifestReferenceV1Dto)non-emptyrequired

Required. List of manifest references to attach at create. Must be non-empty. Each manifest must be in PLANNED status and not already attached to another shipment.

manifests[].​manifestExternalIdstring[ 0 .. 255 ] characters

Caller-assigned manifest external identifier.

manifests[].​manifestUuidstring

Internal manifest identifier (uuid).

customFieldsArray of objects(ShipmentCustomFieldV1Dto)

Optional custom field values to set on the shipment. Each entry must reference a configured field key.

curl -i -X POST \
  https://docs.zimark.link/_mock/api/integration/rest/api/v1/shipment \
  -H 'Content-Type: application/json' \
  -H 'X-AUTH-KEY: YOUR_API_KEY_HERE' \
  -d '{
    "identifier": "string",
    "gateIdentifier": "string",
    "notes": "string",
    "manifests": [
      {
        "manifestExternalId": "string",
        "manifestUuid": "string"
      }
    ],
    "customFields": [
      {
        "deepLink": "string",
        "fieldKey": "string",
        "fieldValue": "string"
      }
    ]
  }'

Responses

OK

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

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

externalIdentifierstring

Caller-assigned external identifier, unique per organization within the Shipment namespace.

statusstring

Lifecycle status of the shipment.

Enum"PLANNED""TO_DO""IN_PROGRESS""COMPLETED""CANCELLED"
gateobject(GateV1Dto)

Gate currently assigned to the shipment, if any.

manifestsArray of objects(ShipmentManifestRefV1Dto)

Manifests currently attached to the shipment.

tracksCountinteger(int64)

Planning view: total tracks (assets) currently included across this shipment's manifests, regardless of loading state. For Total/Loaded execution counts use totalAssetsCount and loadedAssetsCount.

totalAssetsCountinteger(int64)

Total assets attached to the shipment, excluding invalid loadings (WRONGLY_LOADED, UNKNOWN_LOADING) and records belonging to cancelled manifests.

loadedAssetsCountinteger(int64)

Successfully loaded assets, excluding invalid loadings and records belonging to cancelled manifests.

notesstring

Optional free-text notes.

activateDatestring(date-time)

Timestamp when the shipment transitioned to IN_PROGRESS, null if not yet activated.

closeDatestring(date-time)

Timestamp when the shipment transitioned to a terminal status (COMPLETED or CANCELLED), null if still active.

deletedboolean

Soft-delete flag. Deleted shipments are excluded from list and get endpoints.

customFieldsArray of objects(ShipmentCustomFieldV1Dto)

Custom field values set on this shipment. Omitted when the organization's dispatch strategy is not SHIPMENT.

Track

Operations

Gate

Operations

Client

Operations

Scanner

Operations

Printing Batch

Operations

Agent

Operations

Local Manager

Operations

User

Operations

Audit Log

Operations

Alert Events

Operations

Calibration Integration

External API for integration systems with token-based authentication

Operations

Bulk Upsert Management

Operations
Copyright 2026 Zimark Inc © All rights reserved.