object CycleCountBatch

Fields

FieldTypeDescription
idString

Public API ID for this identifiable.

legacy_idBigInt

Numeric legacy ID for this identifiable; use only where legacy IDs are required.

nameString

Human-readable name for this cycle count batch.

warehouse_idString

Public API warehouse ID. Use this when passing or filtering by a warehouse; warehouse fields are display values or nested objects.

account_idString

Public API account ID that identifies the related record.

count_typeDSCycleCountBatchCountTypes

Count type for this cycle count batch.

queue_statusDSCycleCountBatchQueueStatusTypes

Current queue status; use the API status values returned by this field when filtering or updating.

statusString

uncounted | in_progress | closed.

progressInt

Percentage of items counted (0-100).

countedInt

Number of items counted.

uncountedInt

Number of items not yet counted.

due_dateISODateTime

Due date in ISO-8601 date or datetime format, returned in UTC when time is included.

started_atISODateTime

Started at as an ISO-8601 datetime, returned in UTC unless otherwise noted.

ended_atISODateTime

Ended at as an ISO-8601 datetime, returned in UTC unless otherwise noted.

created_atISODateTime

Created at as an ISO-8601 datetime, returned in UTC unless otherwise noted.

updated_atISODateTime

Updated at as an ISO-8601 datetime, returned in UTC unless otherwise noted.

locationsCycleCountProgressType

Location count progress (total/counted).

skusCycleCountProgressType

SKU count progress (total/counted).

Referenced By

Example

{
  "id": "UmVjb3JkOjEyMzQ=",
  "legacy_id": 1234,
  "name": "2",
  "warehouse_id": "Q3ljbGVDb3VudEJhdGNoOjEyMzQ=",
  "account_id": "Q3ljbGVDb3VudEJhdGNoOjEyMzQ=",
  "count_type": "{id: \"Q3ljbGVDb3VudEJhdGNoQ291bnRUeXBlOjEyMzQ=\"}",
  "queue_status": "{id: \"Q3ljbGVDb3VudEJhdGNoUXVldWVTdGF0dXM6MTIzNA==\"}",
  "status": "pending",
  "progress": 2,
  "counted": 2,
  "uncounted": 2,
  "due_date": "2026-07-09T15:30:00Z",
  "started_at": "2026-07-09T15:30:00Z",
  "ended_at": "2026-07-09T15:30:00Z",
  "created_at": "2026-07-09T15:30:00Z",
  "updated_at": "2026-07-09T15:30:00Z",
  "locations": {id: "TG9jYXRpb246MTIzNA==", name: "A01-01-01"},
  "skus": {id: "Q3ljbGVDb3VudFByb2dyZXNzVHlwZToxMjM0"}
}