Pack Owner Reports
Use /api/public/v1/packs for new integrations. The legacy /api/public/v1/boxes endpoints remain supported with the same methods, authentication, and response shapes. Existing fields such as box, boxes, and box_id keep their names for compatibility. Query aliases packId, pack_id, and include_pack are also accepted.
Pack Owner Reports expose the private financial data behind DYLI's daily Pack report and downloadable owner exports. These endpoints are intended for server-to-server accounting, dashboards, and reconciliation.
Authorization
Send a DYLI API key in the x-api-key header. The user attached to the key must be either:
- the
authorPrivyIdowner of the requested Pack; or - a true DYLI admin.
A valid key attached to any other user receives 403 Forbidden. The Pack ID in the path is always checked; a caller cannot request another owner's data by changing a query parameter. Keep the key on your server because these responses can contain private financial and customer-level export data.
curl "https://www.dyli.io/api/public/v1/packs/12997/reports/rollups" \
-H "x-api-key: $DYLI_API_KEY"
Financial Rollups
GET /api/public/v1/packs/{'}boxId{'}/reports/rollupsReturns the same rolling periods used by the daily owner email:
last_24_hourslast_7_days
Each period includes totals for orders, sales, buybacks, claimed items, claimed value, adjustments, DYLI take, and owner earnings. The response also includes the underlying per-product breakdown, current Pack inventory quantity and value, generation time, and whether the Pack has historical orders.
{
"box": { "box_id": 12997, "name": "Slab Starter" },
"generated_at": "2026-09-13T14:00:00.000Z",
"has_historical_orders": true,
"inventory": { "quantity": 366, "value_usd": 24532.14 },
"periods": {
"last_24_hours": {
"totals": {
"orders": 42,
"sales": 1470,
"buybacks": 612.25,
"claimed_items": 8,
"claimed_value": 318.4,
"adjustments": -12.5,
"dyli_take": 0,
"earnings": 845.25
},
"rows": []
},
"last_7_days": { "totals": {}, "rows": [] }
}
}
Order Export
GET /api/public/v1/packs/{'}boxId{'}/reports/ordersReturns the detailed order rows used by the Pack owner export.
curl "https://www.dyli.io/api/public/v1/packs/12997/reports/orders?page=1&pageSize=100" \
-H "x-api-key: $DYLI_API_KEY"
Query parameters:
| Name | Description |
|---|---|
category | orders, claims, or buybacks. Defaults to orders. |
rowType | Optional accounting model filter: legacy, current, claim, or pool. Alias: row_type. |
page, pageSize | JSON pagination. Aliases: page_size. |
format | Defaults to json. Use csv for a downloadable CSV response. |
JSON responses contain rows and pagination. Rows can include buyer identity, order and product IDs, prices, costs, payout estimates, claim/buyback classification, settlement fields, and transaction references.
Adjustment Export
GET /api/public/v1/packs/{'}boxId{'}/reports/adjustmentsReturns the detailed adjustment ledger for one Pack.
curl "https://www.dyli.io/api/public/v1/packs/12997/reports/adjustments?page=1&pageSize=100" \
-H "x-api-key: $DYLI_API_KEY"
Query parameters:
| Name | Description |
|---|---|
rowType | Optional filter: legacy, current, claim, or pool. Alias: row_type. |
page, pageSize | JSON pagination. Aliases: page_size. |
format | Defaults to json. Use csv for a downloadable CSV response. |
JSON responses contain rows, a summary with total_count and total_adjustment, and pagination. Adjustment rows cover machine add-backs, secondary adjustments, discount-code owner charges or reimbursements, and legacy cost adjustments when applicable.
Errors
| Status | Meaning |
|---|---|
400 | Invalid Pack ID or query parameter. |
401 | API key is missing. |
403 | The key is invalid, disabled, expired, or is not attached to the Pack owner/admin. |
404 | The Pack does not exist. |
429 | API-key rate limit exceeded. |
500 / 503 | Reporting data or authentication is temporarily unavailable. |