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

# Get public user profile

> Returns public profile with social accounts, scores, and tags.



## OpenAPI

````yaml /openapi.yaml get /users/{username}
openapi: 3.1.0
info:
  title: Identity Hub API
  version: 1.0.0
  description: TON ecosystem identity and reputation platform.
servers:
  - url: https://api.identityhub.app
    description: Production
security: []
tags:
  - name: Health
    description: Server health checks
  - name: Users
    description: Public user profiles, scores, badges, and contributions
  - name: Contests
    description: Contest listings and submissions
  - name: Blog
    description: Blog posts
  - name: Stats
    description: Platform statistics
paths:
  /users/{username}:
    get:
      tags:
        - Users
      summary: Get public user profile
      description: Returns public profile with social accounts, scores, and tags.
      operationId: getUserProfile
      parameters:
        - schema:
            type: string
          in: path
          name: username
          required: true
          description: Unique username of the user
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - true
                  data:
                    $ref: '#/components/schemas/UserPublicProfile'
                required:
                  - success
                  - data
                additionalProperties: false
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security: []
components:
  schemas:
    UserPublicProfile:
      type: object
      properties:
        id:
          type: string
          description: User UUID
        username:
          anyOf:
            - type: string
            - type: 'null'
          description: Unique username, e.g. "durov"
        displayName:
          anyOf:
            - type: string
            - type: 'null'
          description: Display name, e.g. "Pavel Durov"
        bio:
          anyOf:
            - type: string
            - type: 'null'
          description: User biography
        avatar:
          $ref: '#/components/schemas/Avatar'
        website:
          anyOf:
            - type: string
            - type: 'null'
          description: Personal website URL
        status:
          description: 'Account status: ACTIVATED, NOT_ACTIVATED, DEACTIVATED'
          type: string
        inEcosystemSince:
          description: Earliest ecosystem activity date, rounded to 1st of month (ISO 8601)
          anyOf:
            - type: string
            - type: 'null'
        tags:
          type: array
          items:
            $ref: '#/components/schemas/TagWithTier'
        scores:
          $ref: '#/components/schemas/Scores'
        contributorPercentile:
          description: >-
            Percentile rank among all contributors (0.0–1.0, lower is better;
            0.03 = top 3%)
          anyOf:
            - type: number
            - type: 'null'
        socialAccounts:
          type: array
          items:
            $ref: '#/components/schemas/SocialAccountPublic'
      required:
        - id
        - username
        - displayName
        - bio
        - avatar
        - website
        - tags
        - scores
        - socialAccounts
      additionalProperties: false
      example:
        id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
        username: durov
        displayName: Pavel Durov
        bio: Founder of Telegram & TON
        avatar:
          sm: https://cdn.identityhub.app/avatars/durov_100.webp
          lg: https://cdn.identityhub.app/avatars/durov_256.webp
        website: https://durov.com
        status: ACTIVATED
        inEcosystemSince: '2018-01-01T00:00:00.000Z'
        tags:
          - tag: DEVELOPER
            tier: PLATINUM
          - tag: OG
        scores:
          developer: 92
          builder: 45
          contributor: 78
          telegram: 100
          identity: 85
        contributorPercentile: 0.03
        socialAccounts:
          - platform: GITHUB
            username: durov
            avatar: null
            url: https://github.com/durov
            verified: true
          - platform: TELEGRAM
            username: durov
            avatar: null
            url: https://t.me/durov
            verified: true
            telegramLevel: 5
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
          const: false
        error:
          type: string
        code:
          $ref: '#/components/schemas/ErrorCode'
        details:
          type: array
          items:
            type: object
            properties:
              path:
                type: string
                description: Normalized field path, e.g. "email" or "profile.displayName"
              location:
                type: string
                enum:
                  - body
                  - querystring
                  - params
                  - headers
                  - unknown
                description: Request part where validation failed
              message:
                type: string
                description: Human-readable validation error
              rule:
                description: Validation rule/code (e.g. invalid_type, format)
                type: string
            required:
              - path
              - location
              - message
            additionalProperties: false
      required:
        - success
        - error
      additionalProperties: false
      example:
        success: false
        error: User not found
        code: NOT_FOUND
    Avatar:
      anyOf:
        - type: object
          properties:
            sm:
              type: string
              description: 100x100 WebP avatar URL
            lg:
              type: string
              description: 256x256 WebP avatar URL
          required:
            - sm
            - lg
          additionalProperties: false
        - type: 'null'
    TagWithTier:
      type: object
      properties:
        tag:
          type: string
          enum:
            - DEVELOPER
            - BUILDER
            - CONTRIBUTOR
            - TELEGRAM
            - IDENTITY
            - OG
            - CONTEST_WINNER
          description: Profile tag
        tier:
          description: Tier level
          type: string
          enum:
            - SILVER
            - GOLD
            - PLATINUM
        contestName:
          description: Contest name (for CONTEST_WINNER tag)
          type: string
      required:
        - tag
      additionalProperties: false
    Scores:
      type: object
      properties:
        developer:
          type: number
          description: Developer score (0–100), based on code contributions
        builder:
          type: number
          description: Builder score (0–100), based on projects and repositories
        contributor:
          type: number
          description: Contributor score (0–100), based on community contributions
        telegram:
          type: number
          description: Telegram score (0–100), based on Telegram activity
        identity:
          type: number
          description: >-
            Identity score (0–100), based on profile completeness and
            verification
      required:
        - developer
        - builder
        - contributor
        - telegram
        - identity
      additionalProperties: false
      example:
        developer: 92
        builder: 45
        contributor: 78
        telegram: 100
        identity: 85
    SocialAccountPublic:
      type: object
      properties:
        platform:
          type: string
          enum:
            - GITHUB
            - TELEGRAM
            - X
            - INSTAGRAM
            - LINKEDIN
        username:
          anyOf:
            - type: string
            - type: 'null'
        avatar:
          anyOf:
            - type: string
            - type: 'null'
        url:
          anyOf:
            - type: string
            - type: 'null'
        verified:
          type: boolean
        telegramLevel:
          description: Telegram rating level (TELEGRAM accounts only)
          type: number
        estimatedCreatedAt:
          description: Estimated account creation date (ISO 8601)
          anyOf:
            - type: string
            - type: 'null'
      required:
        - platform
        - username
        - avatar
        - url
        - verified
      additionalProperties: false
    ErrorCode:
      type: string
      enum:
        - UNAUTHORIZED
        - INVALID_TOKEN
        - TOKEN_EXPIRED
        - TOKEN_RIGHTS_OUTDATED
        - ACCOUNT_DEACTIVATED
        - ACCOUNT_ALREADY_DEACTIVATED
        - REFRESH_TOKEN_EXPIRED
        - REFRESH_TOKEN_REUSED
        - REFRESH_TOKEN_INVALID
        - API_KEY_MISSING
        - API_KEY_INVALID
        - AGENT_KEY_INVALID
        - AGENT_KEY_REVOKED
        - AGENT_KEY_RATE_LIMITED
        - AGENT_PROFILE_NOT_FOUND
        - AGENT_NAME_TAKEN
        - AGENT_CLAIM_INVALID
        - AGENT_CLAIM_EXPIRED
        - AGENT_ALREADY_CLAIMED
        - AGENT_NOT_PUBLISHED
        - AGENT_LIMIT_REACHED
        - AGENT_REGISTER_RATE_LIMITED
        - AGENT_CLAIM_RATE_LIMITED
        - SOCIAL_ACCOUNT_ALREADY_LINKED
        - PLATFORM_ALREADY_LINKED
        - LAST_LOGIN_METHOD
        - OAUTH_TOKEN_INVALID
        - OAUTH_PROVIDER_UNSUPPORTED
        - USERNAME_TAKEN
        - USERNAME_RESERVED
        - DISPLAY_NAME_RESERVED
        - RATE_LIMIT_EXCEEDED
        - AUTH_RATE_LIMIT_EXCEEDED
        - GATEWAY_NOT_ELIGIBLE
        - VALIDATION_ERROR
        - NOT_FOUND
        - CONFLICT
        - FORBIDDEN
        - INTERNAL_ERROR
        - DATABASE_ERROR
        - PARSER_ERROR
        - EMAIL_ALREADY_TAKEN
        - EMAIL_CODE_INVALID
        - EMAIL_CODE_EXPIRED
        - EMAIL_RATE_LIMITED
        - EMAIL_SEND_FAILED
        - EMAIL_NOT_LINKED
        - PROOF_PAYLOAD_INVALID
        - PROOF_USER_MISMATCH
        - PROOF_UNSUPPORTED_WALLET
        - PROOF_PUBLIC_KEY_MISMATCH
        - PROOF_ADDRESS_MISMATCH
        - PROOF_DOMAIN_NOT_ALLOWED
        - PROOF_EXPIRED
        - PROOF_SIGNATURE_INVALID
        - PROOF_VERIFICATION_FAILED

````

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