> ## Documentation Index > Fetch the complete documentation index at: https://docs.vibechain.com/llms.txt > Use this file to discover all available pages before exploring further. # Get a BoosterBox by token ID ## OpenAPI ````yaml /api-reference/vibemarket_openapi.yml get / openapi: 3.0.0 info: title: vibe.market Boosterbox API version: 1.0.0 description: > API for managing boosterboxes, games (packs), and metadata on vibe.market. **Get your free API key at:** https://docs.vibechain.com/api-reference/vibemarket-intro **Default Chain:** Base (chainId: 8453) servers: - url: https://build.vibechain.com/vibe/boosterbox security: [] paths: /: get: summary: Get a BoosterBox by token ID parameters: - $ref: '#/components/parameters/API_KEY' - in: query name: tokenId required: true schema: type: integer description: The token ID - in: query name: contractAddress required: true schema: type: string description: The contract address - in: query name: chainId schema: type: integer description: The chain ID - in: query name: includeMetadata schema: type: boolean default: false description: Whether to include metadata - in: query name: includeContractDetails schema: type: boolean default: false description: Whether to include contract details responses: '200': description: Successful response content: application/json: schema: $ref: '#/components/schemas/BoosterBoxResponse' '400': description: Bad request '404': description: BoosterBox not found components: parameters: API_KEY: in: header name: API-KEY description: >- Free API key needed to authorize requests. Get one at: https://docs.vibechain.com/api-reference/vibemarket-intro required: true schema: type: string default: DEMO_REPLACE_WITH_FREE_API_KEY schemas: BoosterBoxResponse: type: object properties: success: type: boolean boosterBox: $ref: '#/components/schemas/BoosterBox' BoosterBox: type: object properties: tokenId: type: integer description: The NFT token ID contractAddress: type: string description: The drop contract address chainId: type: integer description: The chain ID (default 8453 for Base) owner: type: string description: Current owner wallet address status: type: string enum: - minted - rarity_assigned - burned description: Current status of the boosterbox rarity: type: integer minimum: 0 maximum: 4 description: >- Rarity level (0=Common, 1=Uncommon, 2=Rare, 3=Super Rare, 4=Legendary) randomValue: type: string description: Random value used for rarity determination tokenSpecificRandomness: type: string description: Token-specific randomness for foil/wear derivation mintedAt: type: string format: date-time description: Timestamp when the boosterbox was minted openedAt: type: string format: date-time description: Timestamp when the boosterbox was opened latestUpdateTimestamp: type: string format: date-time description: Last update timestamp metadata: $ref: '#/components/schemas/TokenMetadata' contractDetails: $ref: '#/components/schemas/Game' TokenMetadata: type: object description: OpenSea-compatible token metadata properties: name: type: string description: Card name description: type: string description: Card description image: type: string description: Card image URL external_url: type: string description: External URL for the card attributes: type: array description: Card attributes/traits items: type: object properties: trait_type: type: string description: Attribute name (e.g., "Rarity", "Foil", "Wear") value: type: string description: Attribute value display_type: type: string description: Display type for numeric values Game: type: object description: A booster pack collection (game) properties: gameId: type: string description: Unique game identifier tokenAddress: type: string description: ERC20 token contract address for trading tokenName: type: string description: Token name tokenSymbol: type: string description: Token symbol nftName: type: string description: NFT collection name nftSymbol: type: string description: NFT collection symbol description: type: string description: Pack description imageUrl: type: string description: Collection image URL websiteUrl: type: string description: External website URL isGraduated: type: boolean description: Whether the token has graduated to Uniswap marketCap: type: string description: Market cap in wei marketCapUsd: type: string description: Market cap formatted in USD (e.g., "$3,245.67") preorderProgress: type: number description: Progress towards graduation (0-1) pricePerPack: type: string description: Price per pack in wei pricePerPackUsd: type: string description: Price per pack formatted in USD dropContractAddress: type: string description: NFT drop contract address (for minting) ownerAddress: type: string description: Creator's wallet address slug: type: string description: URL-friendly unique identifier bgColor: type: string description: Background color hex code featuredImageUrl: type: string description: Featured image URL packImage: type: string description: Pack image URL isActive: type: boolean description: Whether the pack is active isFeatured: type: boolean description: Whether the pack is featured isVerified: type: boolean description: Whether the pack is verified isVerifiedArtist: type: boolean description: Whether the creator is a verified artist disableFoil: type: boolean description: Whether foil is disabled for this pack disableWear: type: boolean description: Whether wear is disabled for this pack links: type: object description: Social links properties: twitter: type: string discord: type: string website: type: string version: type: string description: Contract version (V1, V2) chainId: type: integer description: Chain ID createdAt: type: string format: date-time updatedAt: type: string format: date-time ````