Skip to main content
GET
List packs in a token range

Authorizations

API-KEY
string
header
required

Caller-specific VibeChain API key used for quota and abuse control.

Headers

X-Bypass-Image-Proxy
boolean
default:false

Set to true to keep original recognized CDN URLs instead of vibe.market proxy URLs. Cache this response variant separately.

Query Parameters

contractAddress
string
required
Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x1111111111111111111111111111111111111111"

tokenIds
string

Comma-separated token IDs. Mutually exclusive with the start/end range.

startTokenId
integer
Required range: x >= 0
endTokenId
integer
Required range: x >= 0
chainId
integer
default:8453

EVM chain ID. Defaults to Base mainnet.

Required range: x >= 1
status
enum<string>
Available options:
minted,
opened,
rarity_assigned,
burned
rarity
integer

0 not assigned, 1 Common, 2 Rare, 3 Epic, 4 Legendary, 5 Mythic.

Required range: 0 <= x <= 5
page
integer
default:1
Required range: x >= 1
limit
integer
default:20

Page size. Endpoint-specific validation may impose a lower maximum.

Required range: x >= 1
sortBy
string
sortOrder
enum<string>
default:desc
Available options:
asc,
desc
includeMetadata
boolean
default:false
includeContractDetails
boolean
default:false
forceRefreshState
boolean
default:false

Queue an onchain state refresh before returning cached data.

Response

A page of packs

success
enum<boolean>
required
Available options:
true
boxes
object[]
required
pagination
object
required