curl -X GET "https://gachabe-staging.fly.dev/api/v1/players/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/vnd.api+json"

{
  "data": {
    "type": "player",
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "attributes": {
      "email": "player@example.com",
      "is_anonymous": false
    },
    "relationships": {
      "chests": {
        "data": [
          {
            "type": "chest",
            "id": "chest_001"
          }
        ]
      }
    }
  },
  "included": [
    {
      "type": "chest",
      "id": "chest_001",
      "attributes": {
        "name": "Dragon Treasure Chest",
        "description": "Contains rare dragon-themed collectibles"
      }
    }
  ],
  "meta": {
    "public_stats": {
      "level": 15,
      "collections_completed": 3,
      "join_date": "2024-01-10T09:00:00Z",
      "last_active": "2024-01-15T16:00:00Z"
    },
    "privacy_level": "public",
    "achievements": [
      {
        "id": "first_collection",
        "name": "First Collection Complete",
        "earned_at": "2024-01-12T14:20:00Z"
      },
      {
        "id": "chest_opener",
        "name": "Chest Enthusiast",
        "earned_at": "2024-01-13T10:30:00Z"
      }
    ]
  }
}
Retrieve detailed information about a specific player by their unique identifier. This endpoint allows viewing public profile information for any player in the system.
This endpoint returns limited public information compared to the /players/me endpoint which provides comprehensive details for the authenticated player.

​
Path Parameters

​
id
string
required
Unique identifier (UUID) of the player to retrieve.

​
Query Parameters

​
include
string
Include related data in the response.Available includes: chests
​
fields
object
Limit response fields to only those specified.
curl -X GET "https://gachabe-staging.fly.dev/api/v1/players/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/vnd.api+json"

{
  "data": {
    "type": "player",
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "attributes": {
      "email": "player@example.com",
      "is_anonymous": false
    },
    "relationships": {
      "chests": {
        "data": [
          {
            "type": "chest",
            "id": "chest_001"
          }
        ]
      }
    }
  },
  "included": [
    {
      "type": "chest",
      "id": "chest_001",
      "attributes": {
        "name": "Dragon Treasure Chest",
        "description": "Contains rare dragon-themed collectibles"
      }
    }
  ],
  "meta": {
    "public_stats": {
      "level": 15,
      "collections_completed": 3,
      "join_date": "2024-01-10T09:00:00Z",
      "last_active": "2024-01-15T16:00:00Z"
    },
    "privacy_level": "public",
    "achievements": [
      {
        "id": "first_collection",
        "name": "First Collection Complete",
        "earned_at": "2024-01-12T14:20:00Z"
      },
      {
        "id": "chest_opener",
        "name": "Chest Enthusiast",
        "earned_at": "2024-01-13T10:30:00Z"
      }
    ]
  }
}

​
Response Fields

​
data
object
required
The requested player’s public profile information
​
meta
object
required
Public statistics and achievements

​
Privacy Considerations

Player profiles respect privacy settings:Public Profiles: Show full stats, achievements, and some chests Friends Only: Limited to friends of the requesting player Private Profiles: Return 403 Forbidden errorAnonymous/guest players always have public profiles with limited information.

​
Common Use Cases

curl -X GET "https://gachabe-staging.fly.dev/api/v1/players/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_API_KEY"
Look up basic information about another player for friend requests or leaderboards.

​
Data Visibility Rules

1

Check privacy settings

The API respects each player’s privacy configuration.
Public profiles show most information, private profiles are blocked.
2

Filter sensitive data

Personal information like full email addresses may be masked.
Only domain names or partial emails are shown for privacy.
3

Show public achievements

Achievements and milestones are generally public unless explicitly hidden.
Players can choose which achievements to display publicly.
4

Respect friend relationships

Some data is only visible to confirmed friends of the player.
Friend-only profiles require friendship verification.

​
Error Scenarios

Never cache player profile data for extended periods as privacy settings, achievements, and stats can change frequently.
This endpoint is useful for social features, leaderboards, and friend systems, but always respects player privacy preferences.