curl -X GET "https://gachabe-staging.fly.dev/api/v1/collectibles/collectible_001" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/vnd.api+json"

{
  "data": {
    "type": "collectible",
    "id": "collectible_001",
    "attributes": {
      "name": "Ancient Dragon Scale",
      "description": "A shimmering scale from an ancient dragon, pulsing with mystical energy. Legend says it was shed during the Great Dragon War and holds the power to protect its bearer from fire-based attacks.",
      "collection_id": "dragon-artifacts",
      "images": [
        "https://example.com/images/dragon-scale-main.png",
        "https://example.com/images/dragon-scale-glowing.png",
        "https://example.com/images/dragon-scale-detail.png"
      ]
    },
    "relationships": {
      "collection": {
        "data": {
          "type": "collection",
          "id": "dragon-artifacts"
        }
      }
    }
  },
  "included": [
    {
      "type": "collection",
      "id": "dragon-artifacts",
      "attributes": {
        "name": "Dragon Artifacts",
        "description": "Ancient treasures and artifacts from the legendary dragon realm"
      },
      "relationships": {
        "collectibles": {
          "data": [
            {
              "type": "collectible",
              "id": "collectible_001"
            },
            {
              "type": "collectible",
              "id": "collectible_002"
            }
          ]
        }
      }
    }
  ],
  "meta": {
    "owned_by_player": true,
    "acquired_at": "2024-01-15T14:35:22Z",
    "rarity_info": {
      "level": "legendary",
      "drop_rate": 0.02
    },
    "collection_progress": {
      "current_item": 1,
      "total_items": 5,
      "completion_percentage": 20
    }
  }
}
Retrieve detailed information about a specific collectible by its unique identifier, including optional collection context.

​
Path Parameters

​
id
string
required
Unique identifier of the collectible to retrieve.

​
Query Parameters

​
include
string
Include related collection data in the response.Available includes: collection
​
fields
object
Limit response fields to only those specified.
curl -X GET "https://gachabe-staging.fly.dev/api/v1/collectibles/collectible_001" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/vnd.api+json"

{
  "data": {
    "type": "collectible",
    "id": "collectible_001",
    "attributes": {
      "name": "Ancient Dragon Scale",
      "description": "A shimmering scale from an ancient dragon, pulsing with mystical energy. Legend says it was shed during the Great Dragon War and holds the power to protect its bearer from fire-based attacks.",
      "collection_id": "dragon-artifacts",
      "images": [
        "https://example.com/images/dragon-scale-main.png",
        "https://example.com/images/dragon-scale-glowing.png",
        "https://example.com/images/dragon-scale-detail.png"
      ]
    },
    "relationships": {
      "collection": {
        "data": {
          "type": "collection",
          "id": "dragon-artifacts"
        }
      }
    }
  },
  "included": [
    {
      "type": "collection",
      "id": "dragon-artifacts",
      "attributes": {
        "name": "Dragon Artifacts",
        "description": "Ancient treasures and artifacts from the legendary dragon realm"
      },
      "relationships": {
        "collectibles": {
          "data": [
            {
              "type": "collectible",
              "id": "collectible_001"
            },
            {
              "type": "collectible",
              "id": "collectible_002"
            }
          ]
        }
      }
    }
  ],
  "meta": {
    "owned_by_player": true,
    "acquired_at": "2024-01-15T14:35:22Z",
    "rarity_info": {
      "level": "legendary",
      "drop_rate": 0.02
    },
    "collection_progress": {
      "current_item": 1,
      "total_items": 5,
      "completion_percentage": 20
    }
  }
}

​
Response Fields

​
data
object
required
The collectible resource object
​
included
array
Related collection data when using include=collection parameter
​
meta
object
Player-specific metadata and collectible statistics

​
Common Use Cases

curl -X GET "https://gachabe-staging.fly.dev/api/v1/collectibles/collectible_001?include=collection" \
  -H "Authorization: Bearer YOUR_API_KEY"
Show comprehensive item details with collection context for a detailed view page.

​
Ownership Context

The meta object includes player-specific information about ownership and acquisition. This allows you to show personalized information about when and how the player obtained the collectible.
1

Check ownership status

Use owned_by_player to determine if the current player has this collectible.
This affects how you display the item (owned vs. discoverable).
2

Show acquisition details

Display acquired_at timestamp for owned items to show collection history.
Use this for “Recently Acquired” sections or collection timelines.
3

Leverage rarity information

Use rarity_info to display special badges or effects for rare items.
Drop rates can help players understand the value of their collectibles.
4

Track collection progress

Show where this item fits within the larger collection using collection_progress.
Perfect for “X of Y collected” progress indicators.

​
Error Handling

Player-specific metadata (ownership, acquisition date) is only available for authenticated requests. Anonymous requests will not include this information.
Use field selection to optimize performance when you don’t need all collectible details, especially for list views or quick lookups.