# Phygitals API

## Docs

- [Get card details](https://dev.phygitals.com/api-reference/cards/get.md): Returns full details for a single card: FMV, metadata, etc.
- [Introduction](https://dev.phygitals.com/api-reference/introduction.md): Base URL, authentication, and the end-to-end partner integration flow.
- [Get user inventory](https://dev.phygitals.com/api-reference/inventory.md): Returns all items currently owned by a user that haven't been sold back or shipped.
- [Get top hits](https://dev.phygitals.com/api-reference/packs/chase.md): Returns all top hits (high-value cards) for a given pack.
- [List available packs](https://dev.phygitals.com/api-reference/packs/list.md): Fetch every pack that can currently be purchased, including pricing, expected value, and rarity distribution.
- [List recent pulls](https://dev.phygitals.com/api-reference/packs/recent-pulls.md): Returns the most recent pulls across one or more packs, newest first.
- [Start a purchase](https://dev.phygitals.com/api-reference/purchase/init.md): Initiates a purchase and returns a session ID to poll for fulfillment.
- [Poll purchase status](https://dev.phygitals.com/api-reference/purchase/status.md): Polls a purchase session for fulfillment and returns the pulled items.
- [Sell back an item](https://dev.phygitals.com/api-reference/sellback.md): Sells an item back to the pack for its buyback_price.
- [Get shipping order](https://dev.phygitals.com/api-reference/shipping/order.md): Returns the full details of a shipping order created via /api/v1/ship/request.
- [Get shipping quote](https://dev.phygitals.com/api-reference/shipping/quote.md): Returns shipping cost and ETA estimates for one or more items to a given destination.
- [Submit shipping request](https://dev.phygitals.com/api-reference/shipping/request.md): Creates a shipping request for the given items using a previously returned quote.
- [Enterprise API](https://dev.phygitals.com/enterprise-api/index.md): The infrastructure for digital collectibles. Build pack, vault, and fulfillment experiences on top of the Phygitals rails.
- [Platform overview](https://dev.phygitals.com/enterprise-api/platform-overview.md): What Phygitals is, how the product works end-to-end, and the trust layer behind every API call.
- [Sandbox](https://dev.phygitals.com/enterprise-api/sandbox.md): Test the Phygitals Partner API end-to-end without consuming inventory, moving real money, or shipping real cards.
- [Use with AI tools](https://dev.phygitals.com/enterprise-api/use-with-ai.md): Export these docs into an LLM, connect them to Claude Code / Cursor, or grab a single file for your dev team.
- [Authentication](https://dev.phygitals.com/public-api/authentication.md): How to send user API keys, what scopes authorize, and how the API responds to auth failures.
- [Public API](https://dev.phygitals.com/public-api/index.md): Programmatic access for Phygitals account holders — browse packs and marketplace listings, buy with crypto, and sell back claw items using user-scoped API keys.
- [Managing API keys](https://dev.phygitals.com/public-api/managing-keys.md): Eligibility requirements, creating and revoking keys, and expiration behavior.
- [Get marketplace filters](https://dev.phygitals.com/public-api/marketplace/filters.md): Returns facet values for building marketplace listing filters.
- [List marketplace listings](https://dev.phygitals.com/public-api/marketplace/listings.md): Search, filter, sort, and paginate cards listed for sale on the Phygitals marketplace.
- [Claw buyback](https://dev.phygitals.com/public-api/marketplace/take-claw-bid.md): Accept an instant buyback offer on a claw item you own — two-step init and finish flow.
- [Get chase cards](https://dev.phygitals.com/public-api/packs/chase.md): Returns all chase (high-value) cards for a given pack.
- [List available packs](https://dev.phygitals.com/public-api/packs/list.md): Fetch every pack that can currently be purchased, including pricing, expected value, and rarity distribution.
- [Buy with crypto](https://dev.phygitals.com/public-api/purchase/crypto.md): Submit a signed crypto payment to open claw packs and receive digital items.
- [Poll purchase status](https://dev.phygitals.com/public-api/purchase/status.md): Check whether a crypto pack purchase has fulfilled and retrieve pulled items.