> ## Documentation Index
> Fetch the complete documentation index at: https://docs.summerengine.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get player profile

> Own active player profile.



## OpenAPI

````yaml scripts/reference/sources/openapi/player.json GET /v1/identity/me/profile
openapi: 3.1.0
info:
  title: Summer Player Game Platform API
  version: summer.player.games/v1
  description: >-
    Public Summer Games store reads, the connected-app OAuth endpoints, and the
    signed-in player's profile and preferences.
servers:
  - url: https://api.summer.games
security:
  - playerBearer: []
paths:
  /v1/identity/me/profile:
    get:
      description: >-
        Own active player profile. A null handle means setup is needed. Display
        names never fall back to authentication IDs. No query parameters;
        no-store responses.
      operationId: getPlayerProfile
      responses:
        '200':
          description: Current canonical profile
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PlayerProfile'
        '401':
          description: Authentication missing or account inactive
        '403':
          description: Player identity.read permission required
        '503':
          description: Profile unavailable
components:
  schemas:
    PlayerProfile:
      type: object
      required:
        - handle
        - displayName
        - version
        - needsProfileSetup
      properties:
        handle:
          type: string
          nullable: true
          pattern: ^[a-z][a-z0-9_]{2,23}$
        displayName:
          type: string
        version:
          type: integer
          minimum: 0
          maximum: 9007199254740991
        needsProfileSetup:
          type: boolean
          description: True exactly when handle is null.
  securitySchemes:
    playerBearer:
      type: http
      scheme: bearer
      description: >-
        A player access token. Store reads need no token. Other apps get a token
        through connected-app OAuth: register the client, let the player approve
        it on summer.games, then exchange the code at the token endpoint.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.