The stock object
Attributes
- idstring
Opaque public identifier for this stock (
stk_prefix + 33 base62 chars). - namestring
Display name of the stock.
- descriptionobjectOptional
Free-text description of the stock.
- stock_items_numbernumber
Total number of stock items in this stock as defined by the designer.
- sales_priceobjectOptional
Authoritative aggregate sales price for the stock (designer-set, admin-approved).
- approval_statusstring
Approval lifecycle status (e.g. pending, approved, rejected).
- design_listarray of PrintFarmStockDesignRefDto
Designs included in this stock.
- region_configarray of PrintFarmStockRegionConfigDto
Per-region configuration. Each entry exposes the manufacturer price for the region.
- extra_parts_configobjectOptional
Free-form extra parts configuration as stored on the stock.
- created_attimestamp
ISO 8601 timestamp of when this stock was created.
- updated_attimestamp
ISO 8601 timestamp of when this stock was last updated.
- approved_atobjectOptional
ISO 8601 timestamp of when this stock was approved. Null when not yet approved.
{
"id": "stk_fL3sB8eYzKnQ7mX2dC9vR4tH6jW1uPbAcN",
"name": "Dragon Figurine Stock",
"description": "Pre-printed dragon figurines, batch of 48.",
"stock_items_number": 48,
"sales_price": "20.00",
"approval_status": "approved",
"design_list": [
{
"design_id": "dsg_kP4xT8aBnLf2sH9eY3jZ5dM7cR1vQbWtJ",
"count": 1
}
],
"region_config": [
{
"region_id": "reg_dF8kP3xL6sV2nH9mT5cR1jY4bQ7wA9uZeM",
"price": "12.50"
}
],
"extra_parts_config": {},
"created_at": "2026-03-24T12:00:00.000Z",
"updated_at": "2026-04-02T15:30:00.000Z",
"approved_at": "2026-03-25T08:30:00.000Z"
}List stocks visible to your print farm
GET/
- Credentials
- An API key with the
READ_STOCKorFULLpermission. - For
- Print farms
- Operation id
listPrintFarmStocks
Returns a paginated list of stocks that have at least one stock_level row at one of your farms, sorted by creation date (newest first). Filter by id, name, or approval_status. Requires an API key with the READ_STOCK (or FULL) permission scope.
Query parameters
- pageinteger
1-based page index.
- page_sizeinteger
Page size (max 100).
- idarray of string
Filter by stock id. Accepts a comma-separated list of UUIDs.
- namestring
Filter by stock name (case-insensitive partial match).
- approval_statusstring
Filter by approval status. Accepts a comma-separated list (e.g.
approved,pending).
Returns200 OK
Paginated list of stocks visible to the authenticated print farm.
Responses
- 200
Paginated list of stocks visible to the authenticated print farm.
- 400
pageorpage_sizeis outside the allowed range. - 401
API key is missing or invalid.
- 403
The API key does not have the required permission scope.
- 429
Rate limit exceeded - wait until the window resets before retrying.
- 500
An unexpected error occurred on our side.
Errors use the print farm error body.
curl "https://public-api.dapi.digital/v1/print-farm/stocks" \
-H "x-api-key: $DAPI_API_KEY"{
"stocks": [
{
"id": "stk_fL3sB8eYzKnQ7mX2dC9vR4tH6jW1uPbAcN",
"name": "Dragon Figurine Stock",
"description": "Pre-printed dragon figurines, batch of 48.",
"stock_items_number": 48,
"sales_price": "20.00",
"approval_status": "approved",
"design_list": [
{
"design_id": "dsg_kP4xT8aBnLf2sH9eY3jZ5dM7cR1vQbWtJ",
"count": 1
}
],
"region_config": [
{
"region_id": "reg_dF8kP3xL6sV2nH9mT5cR1jY4bQ7wA9uZeM",
"price": "12.50"
}
],
"extra_parts_config": {},
"created_at": "2026-03-24T12:00:00.000Z",
"updated_at": "2026-04-02T15:30:00.000Z",
"approved_at": "2026-03-25T08:30:00.000Z"
}
],
"page": 1,
"page_size": 20,
"total": 42
}Get one stock visible to your print farm
GET/
- Credentials
- An API key with the
READ_STOCKorFULLpermission. - For
- Print farms
- Operation id
getPrintFarmStock
Returns a single stock by id, scoped to stocks that have a stock_level row at one of your farms. Requires an API key with the READ_STOCK (or FULL) permission scope.
Path parameters
- idstringRequired
The public stock identifier (
stk_…) returned by the list endpoint.
Returns200 OK
The requested stock. Returns the stock object.
Responses
- 200
The requested stock.
- 401
API key is missing or invalid.
- 403
The API key does not have the required permission scope.
- 404
No stock with this
idhas any stock_level at your print farms. - 429
Rate limit exceeded - wait until the window resets before retrying.
- 500
An unexpected error occurred on our side.
Errors use the print farm error body.
curl "https://public-api.dapi.digital/v1/print-farm/stocks/stk_fL3sB8eYzKnQ7mX2dC9vR4tH6jW1uPbAcN" \
-H "x-api-key: $DAPI_API_KEY"{
"id": "stk_fL3sB8eYzKnQ7mX2dC9vR4tH6jW1uPbAcN",
"name": "Dragon Figurine Stock",
"description": "Pre-printed dragon figurines, batch of 48.",
"stock_items_number": 48,
"sales_price": "20.00",
"approval_status": "approved",
"design_list": [
{
"design_id": "dsg_kP4xT8aBnLf2sH9eY3jZ5dM7cR1vQbWtJ",
"count": 1
}
],
"region_config": [
{
"region_id": "reg_dF8kP3xL6sV2nH9mT5cR1jY4bQ7wA9uZeM",
"price": "12.50"
}
],
"extra_parts_config": {},
"created_at": "2026-03-24T12:00:00.000Z",
"updated_at": "2026-04-02T15:30:00.000Z",
"approved_at": "2026-03-25T08:30:00.000Z"
}