curl -X GET "https://gachabe-staging.fly.dev/api/v1/chests" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/vnd.api+json"
{
  "data": [
    {
      "type": "chest",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "attributes": {
        "name": "Rare Treasure Chest",
        "description": "Contains rare and valuable collectibles",
        "images": [
          "https://example.com/images/rare-chest.png"
        ]
      },
      "relationships": {}
    },
    {
      "type": "chest",
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "attributes": {
        "name": "Common Chest",
        "description": "Basic chest with common items",
        "images": [
          "https://example.com/images/common-chest.png"
        ]
      },
      "relationships": {}
    }
  ],
  "meta": {
    "total_count": 25,
    "page": {
      "limit": 10,
      "offset": 0
    }
  }
}

Query Parameters

filter
object
Filter results based on chest attributes. Supports nested filtering with logical operators.
sort
string
Sort order for results. Use - prefix for descending order.Available fields: id, name, descriptionExample: name,-id (name ascending, then id descending)
page
object
Pagination controls for the response.
include
string
Relationship paths to include in the response. Currently no relationships are supported for chests.
fields
object
Limit response fields to only those specified.
curl -X GET "https://gachabe-staging.fly.dev/api/v1/chests" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/vnd.api+json"
{
  "data": [
    {
      "type": "chest",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "attributes": {
        "name": "Rare Treasure Chest",
        "description": "Contains rare and valuable collectibles",
        "images": [
          "https://example.com/images/rare-chest.png"
        ]
      },
      "relationships": {}
    },
    {
      "type": "chest",
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "attributes": {
        "name": "Common Chest",
        "description": "Basic chest with common items",
        "images": [
          "https://example.com/images/common-chest.png"
        ]
      },
      "relationships": {}
    }
  ],
  "meta": {
    "total_count": 25,
    "page": {
      "limit": 10,
      "offset": 0
    }
  }
}

Response Fields

data
array
required
Array of chest resource objects
meta
object
Metadata about the response, including pagination information

Common Use Cases

curl -X GET "https://gachabe-staging.fly.dev/api/v1/chests?page[limit]=20" \
  -H "Authorization: Bearer YOUR_API_KEY"
Use for displaying a catalog of all available chests to users.