Packs
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.
Packs are collectible pull experiences on DYLI. Use these endpoints to show pack cards, pricing, EV, top remaining hits, odds, inventory, restocking status, and recent pulls.
Rendering cards or packs? Use the artwork guide to keep images proportional without cropping, including in your pull reveal.
Pack owners can also access private financial rollups and export data through Pack Owner Reports.
Pack Summary
GET /api/public/v1/packscurl "https://www.dyli.io/api/public/v1/packs" \
-H "x-api-key: $DYLI_API_KEY"
This returns the live packs users can open: cover art, brand/category, pack type, price, expected value, FMV ratio, average item value, inventory left, top remaining chase items, odds buckets, and whether a pack is restocking or sold out. Results are paginated by default so the endpoint stays quick even as more packs go live.
Query parameters:
| Name | Description |
|---|---|
page, pageSize | Pagination. Defaults to page=1&pageSize=12. pageSize max is 24. Alias: limit. |
chaseLimit | Number of top remaining chase items to include per pack. Defaults to 6, max is 12. Alias: chase_limit. |
boxId | Optional. Return one pack by id. Prefer /api/public/v1/packs/{boxId} when you are linking directly to a known pack. Aliases: box_id, id. |
One Pack
GET /api/public/v1/packs/{'}boxId{'}curl "https://www.dyli.io/api/public/v1/packs/12997" \
-H "x-api-key: $DYLI_API_KEY"
Use this for a pack detail page or catalog card when you already know the pack id. The response returns a single box object with the same fields as the list endpoint.
Pack rows include box_id, name, image_url, cover_image_url, brand, category, subcategory, type, price_usd, expected_value_usd, ev_usd, fmv_ratio, avg_item_value_usd, inventory_count, top_chase_cards, chase_cards, odds_buckets, buyback_rate, buyback_usd_range, buyback_rate_range, metrics_updated_at, top_chase_cards_updated_at, restocking, out_of_stock, and live.
Historical order counts and percentages in buyback_rate_range are cached for up to five minutes. This cache does not include pricing, inventory, or availability.
top_chase_cards shows the highest-value unpulled items still in the pack, the same snapshot DYLI uses for pack cards. Each row includes product_id, token_id, name, image_url, fmv_usd, qty_remaining, brand, category, subcategory, and DYLI links when a product id is available.
Pack Ranges
GET /api/public/v1/packs/{'}boxId{'}/rangescurl "https://www.dyli.io/api/public/v1/packs/12997/ranges" \
-H "x-api-key: $DYLI_API_KEY"
This returns the configured odds ranges for one pack, plus current inventory count and value totals for the whole pack and each range. Unmatched inventory is reported separately. Use includeItems=true when you want the item rows that can land in each bucket.
Query parameters:
| Name | Description |
|---|---|
includeItems | Defaults to false. Set true to include item rows. Alias: include_items. |
page, pageSize | Pages item rows inside each range when includeItems=true. Defaults to page=1&pageSize=25. pageSize max is 100. Alias: limit. |
The box and summary objects include inventory_count and inventory_value_usd. Each range and the unmatched object include inventory_value_usd alongside their existing item counts.
Item rows include product_id, token_id, name, image_url, brand, category, subcategory, cert, box_price, buyback_price, diamond_buyback, rarity, qty_in_box, inventory_value_usd, and range_name.
Pack History
GET /api/public/v1/packs/{'}boxId{'}/historycurl "https://www.dyli.io/api/public/v1/packs/12997/history" \
-H "x-api-key: $DYLI_API_KEY"
This returns what has already been pulled from one pack. Each pull includes the collectible, estimated value, rarity or tier, timestamp, price paid, and buyback result when relevant. To show what is still inside the pack, use /api/public/v1/packs for the top remaining hits or /api/public/v1/packs/{boxId}/ranges?includeItems=true for the full remaining pool.
Query parameters:
| Name | Description |
|---|---|
cursor | Page older pull rows. |
since_id | Incremental mode for newer rows. |
include_box | Defaults to true. Set false to omit summary metadata. |
Verify A Pull
GET /api/public/v1/packs/verifyUse this when you want to show how a completed pack result lines up with the configured odds. Pass either the DYLI order id or the transaction hash.
curl "https://www.dyli.io/api/public/v1/packs/verify?orderId=123456" \
-H "x-api-key: $DYLI_API_KEY"
curl --get "https://www.dyli.io/api/public/v1/packs/verify" \
-H "x-api-key: $DYLI_API_KEY" \
--data-urlencode "txHash=0x..."
The response includes the pack, player, winning item, RNG value, selected range, range odds, and a paginated current prize pool snapshot. It is built for clear public verification, not just a backend status check.
Query parameters:
| Name | Description |
|---|---|
orderId | DYLI order id for the completed pack. |
txHash | Order transaction hash. Use this when you do not have the order id. |
page, pageSize | Pages prize rows in the verification snapshot. Defaults to page=1&pageSize=25. pageSize max is 100. Alias: limit. |