Cycle Count Lines API

Get access to your cycle count lines data through Cloudbox's v1 API.

Retrieving Cycle Count Lines

Individual counted lines across all sessions. Filter by sku_id for a SKU's count history.

Use GET /api/v1/cycle-count-lines to page through every record in your organization, or GET /api/v1/cycle-count-lines/{id} to fetch a single record. The id is a UUID, and a 404 means it doesn't exist in your organization.

API Endpoint

GET
/api/v1/cycle-count-lines
GET
/api/v1/cycle-count-lines/{id}

Required Headers

Every request must include the following:

Header Key
Description
org-api-key
Your Organization API key. Contact Cloudbox Support For Access: support@cloudboxapp.com.
user-api-key
Your User API Key

Requests missing either header will return 401 Unauthorized

Example Request

bash curl -X GET "https://app.cloudboxapp.com/api/v1/cycle-count-lines?limit=100" \ -H "org-api-key: YOUR_ORG_API_KEY" \ -H "user-api-key: YOUR_USER_API_KEY" \ -H "Accept: application/json"

Response Schema

Column
Type
Description
id
string (uuid)
Unique ID
session_id
string (uuid)
References OperationSessions. Filterable (exact)
sku_id
string, nullable
References SKU. Filterable (exact)
container_id
string, nullable
References Containers. Filterable (exact)
unit_mode
boolean
counted_units
integer, nullable
counted_weight
number, nullable
prior_units
number, nullable
prior_weight
number, nullable
gross_weight
number, nullable
tare_weight
number, nullable
net_weight
number, nullable
unit_weight_used
number, nullable
prior_fluid_ounce_qty
number, nullable
final_fluid_ounce_qty
number, nullable
user_id
string (uuid), nullable
created_at
string (ISO 8601)
Creation timestamp (UTC). Sortable

Filters

limitPage size (default 100, max 1000)
offsetNumber of records to skip (default 0)
sortOne of: created_at
orderasc | desc
session_idLines in this count session
sku_idLines for this SKU
container_idLines for this container
created_sinceOnly records created at or after this ISO 8601 timestamp
default sortcreated_at descending

Errors

Cloudbox uses standard HTTP status codes to indicate API success or failure:

  • 200–299 – Request succeeded
  • 400 – Bad request (missing parameters, invalid values)
  • 401 – Unauthorized (missing or invalid API keys)
  • 404 – Resource not found
  • 429 – Too many requests (rate limited)