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

{
  "data": {
    "type": "collection",
    "id": "dragon-artifacts",
    "attributes": {
      "name": "Dragon Artifacts",
      "description": "Ancient treasures and artifacts from the legendary dragon realm. These items hold immense power and are coveted by collectors worldwide."
    },
    "relationships": {
      "collectibles": {
        "data": [
          {
            "type": "collectible",
            "id": "collectible_001"
          },
          {
            "type": "collectible",
            "id": "collectible_002"
          },
          {
            "type": "collectible",
            "id": "collectible_005"
          }
        ]
      }
    }
  },
  "included": [
    {
      "type": "collectible",
      "id": "collectible_001",
      "attributes": {
        "name": "Ancient Dragon Scale",
        "description": "A shimmering scale from an ancient dragon, pulsing with magical energy",
        "collection_id": "dragon-artifacts",
        "images": [
          "https://example.com/images/dragon-scale.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, grants protection to the wearer",
        "collection_id": "dragon-artifacts",
        "images": [
          "https://example.com/images/dragon-pendant.png"
        ]
      },
      "relationships": {
        "collection": {
          "data": {
            "type": "collection",
            "id": "dragon-artifacts"
          }
        }
      }
    }
  ],
  "meta": {
    "collectible_count": 3,
    "collection_completeness": {
      "total_items": 3,
      "unique_items": 3,
      "completion_rate": 1.0
    }
  }
}
Retrieve detailed information about a specific collection by its unique identifier, including optional related collectibles.

​
Path Parameters

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

​
Query Parameters

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

{
  "data": {
    "type": "collection",
    "id": "dragon-artifacts",
    "attributes": {
      "name": "Dragon Artifacts",
      "description": "Ancient treasures and artifacts from the legendary dragon realm. These items hold immense power and are coveted by collectors worldwide."
    },
    "relationships": {
      "collectibles": {
        "data": [
          {
            "type": "collectible",
            "id": "collectible_001"
          },
          {
            "type": "collectible",
            "id": "collectible_002"
          },
          {
            "type": "collectible",
            "id": "collectible_005"
          }
        ]
      }
    }
  },
  "included": [
    {
      "type": "collectible",
      "id": "collectible_001",
      "attributes": {
        "name": "Ancient Dragon Scale",
        "description": "A shimmering scale from an ancient dragon, pulsing with magical energy",
        "collection_id": "dragon-artifacts",
        "images": [
          "https://example.com/images/dragon-scale.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, grants protection to the wearer",
        "collection_id": "dragon-artifacts",
        "images": [
          "https://example.com/images/dragon-pendant.png"
        ]
      },
      "relationships": {
        "collection": {
          "data": {
            "type": "collection",
            "id": "dragon-artifacts"
          }
        }
      }
    }
  ],
  "meta": {
    "collectible_count": 3,
    "collection_completeness": {
      "total_items": 3,
      "unique_items": 3,
      "completion_rate": 1.0
    }
  }
}

​
Response Fields

​
data
object
required
The collection resource object
​
included
array
Full collectible objects when using include=collectibles parameter
​
meta
object
Additional metadata about the collection

​
Common Use Cases

curl -X GET "https://gachabe-staging.fly.dev/api/v1/collections/dragon-artifacts" \
  -H "Authorization: Bearer YOUR_API_KEY"
Get basic collection information for overview pages or collection selection.

​
Collection Relationships

Collections serve as organizational containers for thematically related collectibles. Each collectible belongs to exactly one collection, creating a hierarchical structure that helps players organize and discover items.
1

Understand the hierarchy

Collections group related collectibles by theme, rarity, or source.
Each collectible has a collection_id that references its parent collection.
2

Use includes efficiently

Include collectibles only when displaying full collection details.
For performance, avoid including collectibles in list views or when only collection metadata is needed.
3

Handle completion tracking

Use the metadata to show collection progress to players.
The collection_completeness object shows how many items the current player has collected.
Large collections with many collectibles can result in significant response sizes when using include=collectibles. Consider pagination or separate requests for individual collectibles in such cases.

​
Error Handling