Skip to main content

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 authorPrivyId owner 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/rollups

Returns the same rolling periods used by the daily owner email:

  • last_24_hours
  • last_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/orders

Returns 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:

NameDescription
categoryorders, claims, or buybacks. Defaults to orders.
rowTypeOptional accounting model filter: legacy, current, claim, or pool. Alias: row_type.
page, pageSizeJSON pagination. Aliases: page_size.
formatDefaults 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/adjustments

Returns 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:

NameDescription
rowTypeOptional filter: legacy, current, claim, or pool. Alias: row_type.
page, pageSizeJSON pagination. Aliases: page_size.
formatDefaults 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​

StatusMeaning
400Invalid Pack ID or query parameter.
401API key is missing.
403The key is invalid, disabled, expired, or is not attached to the Pack owner/admin.
404The Pack does not exist.
429API-key rate limit exceeded.
500 / 503Reporting data or authentication is temporarily unavailable.