curl -X GET "https://gachabe-staging.fly.dev/api/v1/collections/dragon-artifacts/collectibles" \
  -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, radiating with mystical power",
        "collection_id": "dragon-artifacts",
        "images": [
          "https://example.com/images/dragon-scale.png",
          "https://example.com/images/dragon-scale-glowing.png"
        ]
      },
      "relationships": {
        "collection": {
          "data": {
            "type": "collection",
            "id": "dragon-artifacts"
          }
        }
      }
    },
    {
      "type": "collectible",
      "id": "collectible_002",
      "attributes": {
        "name": "Dragon Tooth Pendant",
        "description": "A pendant carved from a dragon's tooth, said to grant protection to the wearer",
        "collection_id": "dragon-artifacts",
        "images": [
          "https://example.com/images/dragon-pendant.png"
        ]
      },
      "relationships": {
        "collection": {
          "data": {
            "type": "collection",
            "id": "dragon-artifacts"
          }
        }
      }
    },
    {
      "type": "collectible",
      "id": "collectible_005",
      "attributes": {
        "name": "Dragon Egg Fragment",
        "description": "A piece of fossilized dragon eggshell, incredibly rare and valuable",
        "collection_id": "dragon-artifacts",
        "images": [
          "https://example.com/images/dragon-egg-fragment.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"
            },
            {
              "type": "collectible",
              "id": "collectible_005"
            }
          ]
        }
      }
    }
  ],
  "meta": {
    "total_collectibles": 3,
    "collection_info": {
      "id": "dragon-artifacts",
      "name": "Dragon Artifacts",
      "completion_rate": 0.6
    }
  }
}
Retrieve all collectibles that belong to a specific collection. This endpoint provides a focused view of items within a particular themed collection.

​
Path Parameters

​
id
string
required
Unique identifier of the collection whose collectibles you want 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/collections/dragon-artifacts/collectibles" \
  -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, radiating with mystical power",
        "collection_id": "dragon-artifacts",
        "images": [
          "https://example.com/images/dragon-scale.png",
          "https://example.com/images/dragon-scale-glowing.png"
        ]
      },
      "relationships": {
        "collection": {
          "data": {
            "type": "collection",
            "id": "dragon-artifacts"
          }
        }
      }
    },
    {
      "type": "collectible",
      "id": "collectible_002",
      "attributes": {
        "name": "Dragon Tooth Pendant",
        "description": "A pendant carved from a dragon's tooth, said to grant protection to the wearer",
        "collection_id": "dragon-artifacts",
        "images": [
          "https://example.com/images/dragon-pendant.png"
        ]
      },
      "relationships": {
        "collection": {
          "data": {
            "type": "collection",
            "id": "dragon-artifacts"
          }
        }
      }
    },
    {
      "type": "collectible",
      "id": "collectible_005",
      "attributes": {
        "name": "Dragon Egg Fragment",
        "description": "A piece of fossilized dragon eggshell, incredibly rare and valuable",
        "collection_id": "dragon-artifacts",
        "images": [
          "https://example.com/images/dragon-egg-fragment.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"
            },
            {
              "type": "collectible",
              "id": "collectible_005"
            }
          ]
        }
      }
    }
  ],
  "meta": {
    "total_collectibles": 3,
    "collection_info": {
      "id": "dragon-artifacts",
      "name": "Dragon Artifacts",
      "completion_rate": 0.6
    }
  }
}

​
Response Fields

​
data
array
required
Array of collectible resource objects belonging to this collection
​
included
array
Related collection data when using include=collection parameter
​
meta
object
Metadata about the collection and the current player’s progress

​
Common Use Cases

​
Collection Context

This endpoint provides collectibles within their thematic context. Unlike searching individual collectibles, this ensures you get all items that share the same theme, story, or source.
1

Understand collection scope

Each collection represents a thematic grouping of related collectibles.
All returned collectibles will have the same collection_id as the path parameter.
2

Use for complete collection views

This endpoint is ideal for showing all items within a specific theme or set.
Perfect for “collection completion” features where players want to see what they’re missing.
3

Leverage metadata for progress tracking

Use the completion_rate in metadata to show collection progress.
The completion rate indicates what percentage of the collection the current player owns.

​
Performance Considerations

Large collections can return significant amounts of data. Consider using field selection to optimize response size for specific use cases.
The order of collectibles returned may vary between requests. If you need consistent ordering, consider implementing client-side sorting based on collectible names or IDs.