SKUs
Products in your allocated orders or in stocks you hold, with their designs, extras and stock.
The SKU object
Attributes
- idstring
Opaque public identifier for this SKU (
sku_prefix + 33 base62 chars). Use this value verbatim when referencing the SKU in other endpoints. - nameobjectOptional
Human-readable name of the SKU.
- statusstring
Lifecycle status of the SKU.
Possible valuesactiveinactivedeleted - codestring
Designer-defined code, unique within the designer.
- descriptionobjectOptional
Free-text description of the SKU.
- designsarray of PrintFarmSkuDesignDto
Designs that make up this SKU.
- stocksarray of PrintFarmSkuStockDto
Stocks this SKU participates in.
- extrasarray of PrintFarmSkuExtraDto
Extras attached to this SKU.
- customLabelUrlobjectOptional
Public URL of the custom label set on the owning product (listing) for this SKU. May be an image or a PDF. Null when the product has no custom label.
{
"id": "sku_aB3xKp9wFqZ7vM2nLpHt12cN8jR3sLkPm",
"name": "Dragon Figurine - Red PLA",
"status": "active",
"code": "DRAGON-RED-PLA",
"description": "Red PLA dragon figurine, 100mm tall.",
"designs": [
{
"count": 1,
"design_id": "dsg_kP4xT8aBnLf2sH9eY3jZ5dM7cR1vQbWtJ",
"materials": [
{
"type": "default",
"material_id": "mat_jR6tN9pXq4sL8mB3dK7vH2cF5wYzA1ePsK",
"name": "Transparent Red PLA"
}
]
}
],
"stocks": [
{
"id": "stk_fL3sB8eYzKnQ7mX2dC9vR4tH6jW1uPbAcN",
"enabled": true
}
],
"extras": [
{
"id": "xtr_mW2yH7cVjPq8rT5dN3kFx9eL4bA1uZcRh",
"qty": 1
}
],
"customLabelUrl": "https://cdn.dapi.digital/labels/dragon-figurine.pdf"
}List SKUs visible to your print farm
GET/
- Credentials
- An API key with the
SKUorFULLpermission. - For
- Print farms
- Operation id
listPrintFarmSkus
Returns a paginated list of SKUs visible to your print farm. A SKU is visible if it appears in an order allocated to your farm, or if its stock_list references a stock you hold inventory for. Requires an API key with the SKU (or FULL) permission scope.
Query parameters
- pageinteger
1-based page index.
- page_sizeinteger
Page size (max 100).
- idstring
Filter by SKU id. Accepts a comma-separated list of UUIDs to match any.
- statusstring
Filter by SKU status. Accepts a comma-separated list (active, inactive, deleted).
- codestring
Filter by SKU code (case-insensitive partial match).
Returns200 OK
Paginated list of SKUs visible to the authenticated print farm.
Responses
- 200
Paginated list of SKUs 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/skus" \
-H "x-api-key: $DAPI_API_KEY"{
"skus": [
{
"id": "sku_aB3xKp9wFqZ7vM2nLpHt12cN8jR3sLkPm",
"name": "Dragon Figurine - Red PLA",
"status": "active",
"code": "DRAGON-RED-PLA",
"description": "Red PLA dragon figurine, 100mm tall.",
"designs": [
{
"count": 1,
"design_id": "dsg_kP4xT8aBnLf2sH9eY3jZ5dM7cR1vQbWtJ",
"materials": [
null
]
}
],
"stocks": [
{
"id": "stk_fL3sB8eYzKnQ7mX2dC9vR4tH6jW1uPbAcN",
"enabled": true
}
],
"extras": [
{
"id": "xtr_mW2yH7cVjPq8rT5dN3kFx9eL4bA1uZcRh",
"qty": 1
}
],
"customLabelUrl": "https://cdn.dapi.digital/labels/dragon-figurine.pdf"
}
],
"page": 1,
"page_size": 20,
"total": 42
}Get one SKU visible to your print farm
GET/
- Credentials
- An API key with the
SKUorFULLpermission. - For
- Print farms
- Operation id
getPrintFarmSku
Returns the SKU matching the given id, only if it is visible to your print farm (via an allocated order or held stock). Requires an API key with the SKU (or FULL) permission scope.
Path parameters
- idstringRequired
The public SKU identifier (
sku_…) returned by the list endpoint.
Returns200 OK
The requested SKU. Returns the SKU object.
Responses
- 200
The requested SKU.
- 401
API key is missing or invalid.
- 403
The API key does not have the required permission scope.
- 404
No SKU with this
idis visible to your print farm. - 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/skus/sku_aB3xKp9wFqZ7vM2nLpHt12cN8jR3sLkPm" \
-H "x-api-key: $DAPI_API_KEY"{
"id": "sku_aB3xKp9wFqZ7vM2nLpHt12cN8jR3sLkPm",
"name": "Dragon Figurine - Red PLA",
"status": "active",
"code": "DRAGON-RED-PLA",
"description": "Red PLA dragon figurine, 100mm tall.",
"designs": [
{
"count": 1,
"design_id": "dsg_kP4xT8aBnLf2sH9eY3jZ5dM7cR1vQbWtJ",
"materials": [
{
"type": "default",
"material_id": "mat_jR6tN9pXq4sL8mB3dK7vH2cF5wYzA1ePsK",
"name": "Transparent Red PLA"
}
]
}
],
"stocks": [
{
"id": "stk_fL3sB8eYzKnQ7mX2dC9vR4tH6jW1uPbAcN",
"enabled": true
}
],
"extras": [
{
"id": "xtr_mW2yH7cVjPq8rT5dN3kFx9eL4bA1uZcRh",
"qty": 1
}
],
"customLabelUrl": "https://cdn.dapi.digital/labels/dragon-figurine.pdf"
}