> ## 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 detailed scoring breakdown

> Returns per-dimension scores, percentiles, and metric-level breakdowns for a user.



## OpenAPI

````yaml /openapi.yaml get /users/{username}/scores
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}/scores:
    get:
      tags:
        - Users
      summary: Get detailed scoring breakdown
      description: >-
        Returns per-dimension scores, percentiles, and metric-level breakdowns
        for a user.
      operationId: getUserScores
      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:
                    type: object
                    properties:
                      developer:
                        type: object
                        properties:
                          score:
                            type: number
                          percentile:
                            anyOf:
                              - type: number
                              - type: 'null'
                          breakdown:
                            type: object
                            propertyNames:
                              type: string
                            additionalProperties:
                              type: object
                              properties:
                                value:
                                  anyOf:
                                    - type: number
                                    - type: 'null'
                                score:
                                  type: number
                                maxScore:
                                  type: number
                              required:
                                - value
                                - score
                                - maxScore
                              additionalProperties: false
                        required:
                          - score
                          - percentile
                          - breakdown
                        additionalProperties: false
                      builder:
                        type: object
                        properties:
                          score:
                            type: number
                          percentile:
                            anyOf:
                              - type: number
                              - type: 'null'
                          breakdown:
                            type: object
                            propertyNames:
                              type: string
                            additionalProperties:
                              type: object
                              properties:
                                value:
                                  anyOf:
                                    - type: number
                                    - type: 'null'
                                score:
                                  type: number
                                maxScore:
                                  type: number
                              required:
                                - value
                                - score
                                - maxScore
                              additionalProperties: false
                        required:
                          - score
                          - percentile
                          - breakdown
                        additionalProperties: false
                      contributor:
                        type: object
                        properties:
                          score:
                            type: number
                          percentile:
                            anyOf:
                              - type: number
                              - type: 'null'
                          breakdown:
                            type: object
                            propertyNames:
                              type: string
                            additionalProperties:
                              type: object
                              properties:
                                value:
                                  anyOf:
                                    - type: number
                                    - type: 'null'
                                score:
                                  type: number
                                maxScore:
                                  type: number
                              required:
                                - value
                                - score
                                - maxScore
                              additionalProperties: false
                        required:
                          - score
                          - percentile
                          - breakdown
                        additionalProperties: false
                      telegram:
                        type: object
                        properties:
                          score:
                            type: number
                          percentile:
                            anyOf:
                              - type: number
                              - type: 'null'
                          breakdown:
                            type: object
                            propertyNames:
                              type: string
                            additionalProperties:
                              type: object
                              properties:
                                value:
                                  anyOf:
                                    - type: number
                                    - type: 'null'
                                score:
                                  type: number
                                maxScore:
                                  type: number
                              required:
                                - value
                                - score
                                - maxScore
                              additionalProperties: false
                        required:
                          - score
                          - percentile
                          - breakdown
                        additionalProperties: false
                      identity:
                        type: object
                        properties:
                          score:
                            type: number
                          percentile:
                            anyOf:
                              - type: number
                              - type: 'null'
                          breakdown:
                            type: object
                            propertyNames:
                              type: string
                            additionalProperties:
                              type: object
                              properties:
                                value:
                                  anyOf:
                                    - type: number
                                    - type: 'null'
                                score:
                                  type: number
                                maxScore:
                                  type: number
                              required:
                                - value
                                - score
                                - maxScore
                              additionalProperties: false
                        required:
                          - score
                          - percentile
                          - breakdown
                        additionalProperties: false
                    required:
                      - developer
                      - builder
                      - contributor
                      - telegram
                      - identity
                    additionalProperties: false
                required:
                  - success
                  - data
                additionalProperties: false
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security: []
components:
  schemas:
    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
    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.