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

# Profile by auth ID

> Returns a simplified profile by auth UUID. **Permission required:** `api.lookup`.

Returns a **SimplifiedProfile** by auth UUID (v4). Requires permission **`api.lookup`**.


## OpenAPI

````yaml GET /lookup/auth-id/{authId}
openapi: 3.1.0
info:
  title: frozi.lol API
  description: >-
    REST API for frozi.lol. Access profile data, leaderboard, and
    profile-related content (e.g. links). All endpoints require a valid API key.
  version: 1.0.0
servers:
  - url: https://frozi.lol/api
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Leaderboard
    description: Top profiles by view count
  - name: Lookup
    description: Profile and links lookup by username, UID, or auth ID
paths:
  /lookup/auth-id/{authId}:
    get:
      tags:
        - Lookup
      summary: Profile by auth ID
      description: >-
        Returns a simplified profile by auth UUID. **Permission required:**
        `api.lookup`.
      operationId: lookupByAuthId
      parameters:
        - name: authId
          in: path
          description: Auth UUID (v4)
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Simplified profile
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SimplifiedProfile'
        default:
          description: >-
            Error response. See [Errors](/api-reference/errors) for status codes
            and format.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    SimplifiedProfile:
      type: object
      description: >-
        Public profile representation. Email and other private fields are never
        returned.
      properties:
        id:
          type: integer
          description: Profile ID
        username:
          type: string
        displayName:
          type: string
        badges:
          type: array
          items:
            type: object
            properties:
              name:
                type: string
              enabled:
                type: boolean
        assets:
          type: object
          additionalProperties:
            type: string
            nullable: true
        customize:
          type: object
        discordID:
          type: string
          nullable: true
        discordClean:
          type: object
        banned:
          type: boolean
        viewsCount:
          type: number
        followersCount:
          type: number
          nullable: true
          description: Null if profile has 'show followers count' disabled
        createdAt:
          type: string
          format: date-time
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          description: Human-readable error message
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        API key from Dashboard → Developer Platform → API Keys. Send as:
        Authorization: Bearer <API_KEY>

````