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

# Get User Details (/api-reference/fansly/users/get-user-details)

Get Fansly profile details for one or more usernames. Pass a single username or a comma-separated list to fetch multiple profiles in a single call — bulk requests still only cost one API credit.

## OpenAPI

````yaml https://app.onlyfansapi.com/scribe-fansly-docs/openapi.yaml get /api/fansly/{fanslyAccount}/users/{usernames}
openapi: 3.0.3
info:
  title: Fansly API Documentation
  description: ""
  version: 1.0.0
servers:
  - url: https://app.onlyfansapi.com
security:
  - default: []
tags:
  - name: Account
    description: Endpoints for your linked Fansly accounts
  - name: Chats
    description: Endpoints for Fansly chats (messaging groups)
  - name: Earnings
    description: Endpoints for Fansly Earnings — wallets, balances, transactions,
      payouts, and statements.
  - name: Followers
    description: Endpoints for Fansly followers.
  - name: Lists
    description: Endpoints for Fansly subscriber/fan lists (e.g. "VIP", "Spenders").
  - name: Profile Statistics
    description: Endpoints for Fansly Profile Statistics (viewer engagement insights).
  - name: Subscribers
    description: Endpoints for Fansly subscribers and subscription tiers.
  - name: Top Supporters
    description: Endpoints for the Fansly "Top Supporters" view — see who spends the
      most and what they spend on.
  - name: Tracking Links
    description: Endpoints for Fansly tracking links — per-source attribution links
      (e.g. "Twitter bio", "FYP", "Search").
  - name: Users
    description: APIs for fetching Fansly users
paths:
  /api/fansly/{fanslyAccount}/users/{usernames}:
    parameters:
      - in: path
        name: fanslyAccount
        description: The Fansly Account ID
        example: fansly_acct_XXXXXXXXXXXXXXX
        required: true
        schema:
          type: string
      - in: path
        name: usernames
        description: A Fansly username, or a comma-separated list of usernames.
        example: exampleuser
        required: true
        schema:
          type: string
    get:
      summary: Get User Details
      operationId: getUserDetails
      description: Get Fansly profile details for one or more usernames. Pass a single
        username or a comma-separated list to fetch multiple profiles in a
        single call — bulk requests still only cost one API credit.
      parameters: []
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                type: object
                example:
                  data:
                    - id: "100000000000000001"
                      username: exampleuser
                      displayName: null
                      flags: 18
                      version: 3
                      followCount: 1000
                      subscriberCount: 0
                      permissions:
                        accountPermissionFlags:
                          flags: 2
                      timelineStats:
                        accountId: "100000000000000001"
                        imageCount: 200
                        videoCount: 100
                        bundleCount: 10
                        bundleImageCount: 50
                        bundleVideoCount: 0
                        fetchedAt: 1700000000000
                      mediaStoryState:
                        accountId: "100000000000000001"
                        status: 2
                        storyCount: 0
                        version: 1
                        createdAt: 1700000000000
                        updatedAt: 1700000000000
                        hasActiveStories: false
                      statusId: 1
                      lastSeenAt: 1700000000000
                      profileAccessFlags: 0
                      profileFlags: 0
                      about: About text
                      location: ""
                      profileSocials: []
                      profileBadges: []
                      following: true
                      accountMediaLikes: 1000
                      hasMainWall: true
                      walls:
                        - id: "200000000000000001"
                          accountId: "100000000000000001"
                          pos: 0
                          name: Posts
                          description: ""
                          private: 0
                          metadata: ""
                          defaultWall: true
                          mainWall: true
                      avatar:
                        id: "300000000000000001"
                        type: 1
                        status: 1
                        accountId: "100000000000000001"
                        mimetype: image/jpeg
                        flags: 0
                        location: /100000000000000001/300000000000000001.jpeg
                        width: 1080
                        height: 1440
                        metadata: '{"resolutionMode":2}'
                        updatedAt: 1700000000
                        createdAt: 1700000000
                        variants:
                          - id: "300000000000000002"
                            type: 1
                            status: 1
                            mimetype: image/jpeg
                            flags: 0
                            location: /100000000000000001/300000000000000002.jpeg
                            width: 720
                            height: 960
                            metadata: '{"resolutionMode":2}'
                            updatedAt: 1700000000
                            locations:
                              - locationId: "1"
                                location: https://cdn3.fansly.com/100000000000000001/300000000000000002.jpeg
                        variantHash: {}
                        locations:
                          - locationId: "1"
                            location: https://cdn3.fansly.com/100000000000000001/300000000000000001.jpeg
                      banner:
                        id: "400000000000000001"
                        type: 1
                        status: 1
                        accountId: "100000000000000001"
                        mimetype: image/jpeg
                        flags: 0
                        location: /100000000000000001/400000000000000001.jpeg
                        width: 1920
                        height: 1080
                        metadata: '{"resolutionMode":1}'
                        updatedAt: 1700000000
                        createdAt: 1700000000
                        variants: []
                        variantHash: {}
                        locations:
                          - locationId: "1"
                            location: https://cdn3.fansly.com/100000000000000001/400000000000000001.jpeg
                      streaming:
                        accountId: "100000000000000001"
                        channel: null
                        enabled: true
                      postLikes: 100
                      subscriptionTiers:
                        - id: "500000000000000001"
                          accountId: "100000000000000001"
                          name: Subscription
                          color: "#444444"
                          pos: 0
                          price: 5000
                          maxSubscribers: 0
                          subscriptionBenefits:
                            - Benefit one
                            - Benefit two
                          includedTierIds: []
                          plans:
                            - id: "500000000000000002"
                              status: 1
                              billingCycle: 30
                              price: 10000
                              useAmounts: 0
                              promos: []
                              uses: 0
                      profileAccess: true
                  _meta:
                    _credits:
                      used: 1
                      balance: 10055812
                      note: Always
                    _cache:
                      is_cached: false
                      note: Cache disabled for this endpoint
                    _rate_limits:
                      limit_minute: 5000
                      limit_day: null
                      remaining_minute: 4999
                      remaining_day: null
                      notice: We have decided to remove our daily rate limits. Please remove any
                        references to these in your integrations.
                properties:
                  data:
                    type: array
                    example:
                      - id: "100000000000000001"
                        username: exampleuser
                        displayName: null
                        flags: 18
                        version: 3
                        followCount: 1000
                        subscriberCount: 0
                        permissions:
                          accountPermissionFlags:
                            flags: 2
                        timelineStats:
                          accountId: "100000000000000001"
                          imageCount: 200
                          videoCount: 100
                          bundleCount: 10
                          bundleImageCount: 50
                          bundleVideoCount: 0
                          fetchedAt: 1700000000000
                        mediaStoryState:
                          accountId: "100000000000000001"
                          status: 2
                          storyCount: 0
                          version: 1
                          createdAt: 1700000000000
                          updatedAt: 1700000000000
                          hasActiveStories: false
                        statusId: 1
                        lastSeenAt: 1700000000000
                        profileAccessFlags: 0
                        profileFlags: 0
                        about: About text
                        location: ""
                        profileSocials: []
                        profileBadges: []
                        following: true
                        accountMediaLikes: 1000
                        hasMainWall: true
                        walls:
                          - id: "200000000000000001"
                            accountId: "100000000000000001"
                            pos: 0
                            name: Posts
                            description: ""
                            private: 0
                            metadata: ""
                            defaultWall: true
                            mainWall: true
                        avatar:
                          id: "300000000000000001"
                          type: 1
                          status: 1
                          accountId: "100000000000000001"
                          mimetype: image/jpeg
                          flags: 0
                          location: /100000000000000001/300000000000000001.jpeg
                          width: 1080
                          height: 1440
                          metadata: '{"resolutionMode":2}'
                          updatedAt: 1700000000
                          createdAt: 1700000000
                          variants:
                            - id: "300000000000000002"
                              type: 1
                              status: 1
                              mimetype: image/jpeg
                              flags: 0
                              location: /100000000000000001/300000000000000002.jpeg
                              width: 720
                              height: 960
                              metadata: '{"resolutionMode":2}'
                              updatedAt: 1700000000
                              locations:
                                - locationId: "1"
                                  location: https://cdn3.fansly.com/100000000000000001/300000000000000002.jpeg
                          variantHash: []
                          locations:
                            - locationId: "1"
                              location: https://cdn3.fansly.com/100000000000000001/300000000000000001.jpeg
                        banner:
                          id: "400000000000000001"
                          type: 1
                          status: 1
                          accountId: "100000000000000001"
                          mimetype: image/jpeg
                          flags: 0
                          location: /100000000000000001/400000000000000001.jpeg
                          width: 1920
                          height: 1080
                          metadata: '{"resolutionMode":1}'
                          updatedAt: 1700000000
                          createdAt: 1700000000
                          variants: []
                          variantHash: []
                          locations:
                            - locationId: "1"
                              location: https://cdn3.fansly.com/100000000000000001/400000000000000001.jpeg
                        streaming:
                          accountId: "100000000000000001"
                          channel: null
                          enabled: true
                        postLikes: 100
                        subscriptionTiers:
                          - id: "500000000000000001"
                            accountId: "100000000000000001"
                            name: Subscription
                            color: "#444444"
                            pos: 0
                            price: 5000
                            maxSubscribers: 0
                            subscriptionBenefits:
                              - Benefit one
                              - Benefit two
                            includedTierIds: []
                            plans:
                              - id: "500000000000000002"
                                status: 1
                                billingCycle: 30
                                price: 10000
                                useAmounts: 0
                                promos: []
                                uses: 0
                        profileAccess: true
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          example: "100000000000000001"
                        username:
                          type: string
                          example: exampleuser
                        displayName:
                          type: string
                          example: null
                          nullable: true
                        flags:
                          type: integer
                          example: 18
                        version:
                          type: integer
                          example: 3
                        followCount:
                          type: integer
                          example: 1000
                        subscriberCount:
                          type: integer
                          example: 0
                        permissions:
                          type: object
                          properties:
                            accountPermissionFlags:
                              type: object
                              properties:
                                flags:
                                  type: integer
                                  example: 2
                        timelineStats:
                          type: object
                          properties:
                            accountId:
                              type: string
                              example: "100000000000000001"
                            imageCount:
                              type: integer
                              example: 200
                            videoCount:
                              type: integer
                              example: 100
                            bundleCount:
                              type: integer
                              example: 10
                            bundleImageCount:
                              type: integer
                              example: 50
                            bundleVideoCount:
                              type: integer
                              example: 0
                            fetchedAt:
                              type: integer
                              example: 1700000000000
                        mediaStoryState:
                          type: object
                          properties:
                            accountId:
                              type: string
                              example: "100000000000000001"
                            status:
                              type: integer
                              example: 2
                            storyCount:
                              type: integer
                              example: 0
                            version:
                              type: integer
                              example: 1
                            createdAt:
                              type: integer
                              example: 1700000000000
                            updatedAt:
                              type: integer
                              example: 1700000000000
                            hasActiveStories:
                              type: boolean
                              example: false
                        statusId:
                          type: integer
                          example: 1
                        lastSeenAt:
                          type: integer
                          example: 1700000000000
                        profileAccessFlags:
                          type: integer
                          example: 0
                        profileFlags:
                          type: integer
                          example: 0
                        about:
                          type: string
                          example: About text
                        location:
                          type: string
                          example: ""
                        profileSocials:
                          type: array
                          example: []
                        profileBadges:
                          type: array
                          example: []
                        following:
                          type: boolean
                          example: true
                        accountMediaLikes:
                          type: integer
                          example: 1000
                        hasMainWall:
                          type: boolean
                          example: true
                        walls:
                          type: array
                          example:
                            - id: "200000000000000001"
                              accountId: "100000000000000001"
                              pos: 0
                              name: Posts
                              description: ""
                              private: 0
                              metadata: ""
                              defaultWall: true
                              mainWall: true
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                                example: "200000000000000001"
                              accountId:
                                type: string
                                example: "100000000000000001"
                              pos:
                                type: integer
                                example: 0
                              name:
                                type: string
                                example: Posts
                              description:
                                type: string
                                example: ""
                              private:
                                type: integer
                                example: 0
                              metadata:
                                type: string
                                example: ""
                              defaultWall:
                                type: boolean
                                example: true
                              mainWall:
                                type: boolean
                                example: true
                        avatar:
                          type: object
                          properties:
                            id:
                              type: string
                              example: "300000000000000001"
                            type:
                              type: integer
                              example: 1
                            status:
                              type: integer
                              example: 1
                            accountId:
                              type: string
                              example: "100000000000000001"
                            mimetype:
                              type: string
                              example: image/jpeg
                            flags:
                              type: integer
                              example: 0
                            location:
                              type: string
                              example: /100000000000000001/300000000000000001.jpeg
                            width:
                              type: integer
                              example: 1080
                            height:
                              type: integer
                              example: 1440
                            metadata:
                              type: string
                              example: '{"resolutionMode":2}'
                            updatedAt:
                              type: integer
                              example: 1700000000
                            createdAt:
                              type: integer
                              example: 1700000000
                            variants:
                              type: array
                              example:
                                - id: "300000000000000002"
                                  type: 1
                                  status: 1
                                  mimetype: image/jpeg
                                  flags: 0
                                  location: /100000000000000001/300000000000000002.jpeg
                                  width: 720
                                  height: 960
                                  metadata: '{"resolutionMode":2}'
                                  updatedAt: 1700000000
                                  locations:
                                    - locationId: "1"
                                      location: https://cdn3.fansly.com/100000000000000001/300000000000000002.jpeg
                              items:
                                type: object
                                properties:
                                  id:
                                    type: string
                                    example: "300000000000000002"
                                  type:
                                    type: integer
                                    example: 1
                                  status:
                                    type: integer
                                    example: 1
                                  mimetype:
                                    type: string
                                    example: image/jpeg
                                  flags:
                                    type: integer
                                    example: 0
                                  location:
                                    type: string
                                    example: /100000000000000001/300000000000000002.jpeg
                                  width:
                                    type: integer
                                    example: 720
                                  height:
                                    type: integer
                                    example: 960
                                  metadata:
                                    type: string
                                    example: '{"resolutionMode":2}'
                                  updatedAt:
                                    type: integer
                                    example: 1700000000
                                  locations:
                                    type: array
                                    example:
                                      - locationId: "1"
                                        location: https://cdn3.fansly.com/100000000000000001/300000000000000002.jpeg
                                    items:
                                      type: object
                                      properties:
                                        locationId:
                                          type: string
                                          example: "1"
                                        location:
                                          type: string
                                          example: https://cdn3.fansly.com/100000000000000001/300000000000000002.jpeg
                            variantHash:
                              type: object
                              properties: {}
                            locations:
                              type: array
                              example:
                                - locationId: "1"
                                  location: https://cdn3.fansly.com/100000000000000001/300000000000000001.jpeg
                              items:
                                type: object
                                properties:
                                  locationId:
                                    type: string
                                    example: "1"
                                  location:
                                    type: string
                                    example: https://cdn3.fansly.com/100000000000000001/300000000000000001.jpeg
                        banner:
                          type: object
                          properties:
                            id:
                              type: string
                              example: "400000000000000001"
                            type:
                              type: integer
                              example: 1
                            status:
                              type: integer
                              example: 1
                            accountId:
                              type: string
                              example: "100000000000000001"
                            mimetype:
                              type: string
                              example: image/jpeg
                            flags:
                              type: integer
                              example: 0
                            location:
                              type: string
                              example: /100000000000000001/400000000000000001.jpeg
                            width:
                              type: integer
                              example: 1920
                            height:
                              type: integer
                              example: 1080
                            metadata:
                              type: string
                              example: '{"resolutionMode":1}'
                            updatedAt:
                              type: integer
                              example: 1700000000
                            createdAt:
                              type: integer
                              example: 1700000000
                            variants:
                              type: array
                              example: []
                            variantHash:
                              type: object
                              properties: {}
                            locations:
                              type: array
                              example:
                                - locationId: "1"
                                  location: https://cdn3.fansly.com/100000000000000001/400000000000000001.jpeg
                              items:
                                type: object
                                properties:
                                  locationId:
                                    type: string
                                    example: "1"
                                  location:
                                    type: string
                                    example: https://cdn3.fansly.com/100000000000000001/400000000000000001.jpeg
                        streaming:
                          type: object
                          properties:
                            accountId:
                              type: string
                              example: "100000000000000001"
                            channel:
                              type: string
                              example: null
                              nullable: true
                            enabled:
                              type: boolean
                              example: true
                        postLikes:
                          type: integer
                          example: 100
                        subscriptionTiers:
                          type: array
                          example:
                            - id: "500000000000000001"
                              accountId: "100000000000000001"
                              name: Subscription
                              color: "#444444"
                              pos: 0
                              price: 5000
                              maxSubscribers: 0
                              subscriptionBenefits:
                                - Benefit one
                                - Benefit two
                              includedTierIds: []
                              plans:
                                - id: "500000000000000002"
                                  status: 1
                                  billingCycle: 30
                                  price: 10000
                                  useAmounts: 0
                                  promos: []
                                  uses: 0
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                                example: "500000000000000001"
                              accountId:
                                type: string
                                example: "100000000000000001"
                              name:
                                type: string
                                example: Subscription
                              color:
                                type: string
                                example: "#444444"
                              pos:
                                type: integer
                                example: 0
                              price:
                                type: integer
                                example: 5000
                              maxSubscribers:
                                type: integer
                                example: 0
                              subscriptionBenefits:
                                type: array
                                example:
                                  - Benefit one
                                  - Benefit two
                                items:
                                  type: string
                              includedTierIds:
                                type: array
                                example: []
                              plans:
                                type: array
                                example:
                                  - id: "500000000000000002"
                                    status: 1
                                    billingCycle: 30
                                    price: 10000
                                    useAmounts: 0
                                    promos: []
                                    uses: 0
                                items:
                                  type: object
                                  properties:
                                    id:
                                      type: string
                                      example: "500000000000000002"
                                    status:
                                      type: integer
                                      example: 1
                                    billingCycle:
                                      type: integer
                                      example: 30
                                    price:
                                      type: integer
                                      example: 10000
                                    useAmounts:
                                      type: integer
                                      example: 0
                                    promos:
                                      type: array
                                      example: []
                                    uses:
                                      type: integer
                                      example: 0
                        profileAccess:
                          type: boolean
                          example: true
                  _meta:
                    type: object
                    properties:
                      _credits:
                        type: object
                        properties:
                          used:
                            type: integer
                            example: 1
                          balance:
                            type: integer
                            example: 10055812
                          note:
                            type: string
                            example: Always
                      _cache:
                        type: object
                        properties:
                          is_cached:
                            type: boolean
                            example: false
                          note:
                            type: string
                            example: Cache disabled for this endpoint
                      _rate_limits:
                        type: object
                        properties:
                          limit_minute:
                            type: integer
                            example: 5000
                          limit_day:
                            type: string
                            example: null
                            nullable: true
                          remaining_minute:
                            type: integer
                            example: 4999
                          remaining_day:
                            type: string
                            example: null
                            nullable: true
                          notice:
                            type: string
                            example: We have decided to remove our daily rate limits. Please remove any
                              references to these in your integrations.
      tags:
        - Users
components:
  securitySchemes:
    default:
      type: http
      scheme: bearer
      description: Get your API Key from OnlyFansAPI Console -
        https://app.onlyfansapi.com/api-keys
````