> ## 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. # Mass-List User Details (/api-reference/users/mass-list-user-details) Save on credits by getting up to 10 user details with a single request. User details are retrieved using the current `{account}` so fields like `subscribedOnData` which include potential subscription details will be included. ## OpenAPI ````yaml https://app.onlyfansapi.com/scribe-docs/openapi.yaml get /api/{account}/users/list openapi: 3.0.3 info: title: OnlyFans API description: "" version: 1.0.0 servers: - url: https://app.onlyfansapi.com security: - default: [] tags: - name: API Keys description: "" - name: Account description: Endpoints for your linked accounts - name: Analytics - Financial description: APIs for retrieving financial analytics data - name: Analytics - Summary description: APIs for retrieving summary analytics data - name: Banking description: Operations related to user banking details, payout methods, legal and tax information, and account country settings. - name: Chargebacks description: "" - name: Chat Messages description: "" - name: Chats description: "" - name: Client Sessions description: "" - name: Connect OnlyFans Account description: "" - name: Data Exports description: APIs for managing data exports - name: Engagement / Messages description: "" - name: Fans description: APIs for managing OnlyFans fans (subscribers) - name: Fans - AI Summary description: APIs for generating and retrieving AI-powered fan profile summaries - name: Following description: APIs for managing OnlyFans followings (people you're subscribed to) - name: Free Trial Links description: APIs for managing Free Trial Links - name: Giphy description: "" - name: Link Tags description: APIs for managing tags on free trial links and tracking links - name: Mass Messaging description: "" - name: Media description: "" - name: Media Vault description: "" - name: Media Vault Lists description: "" - name: Notifications description: Endpoints for managingr account notifications - name: Payouts description: "" - name: Post Comments description: "" - name: Post Labels description: APIs for managing your post labels - name: Posts description: APIs for managing OnlyFans posts - name: Promotions description: "" - name: Public Profiles description: "" - name: Queue description: "" - name: Release Forms description: APIs for managing OnlyFans release forms - name: Saved For Later (Messages) description: "" - name: Saved For Later (Posts) description: "" - name: Settings description: "" - name: Shared Free Trial Links description: APIs for Free Trial Links that other OF creators have shared with this account. Revenue, cost, and spender data are not available for shared links. - name: Shared Tracking Links description: APIs for Tracking Links (campaigns) that other OF creators have shared with this account. Revenue, cost, and spender data are not available for shared campaigns. - name: Smart Link Postbacks description: APIs for managing Smart Link postback destinations - name: Smart Links description: APIs for managing Smart Links (Free Trial Links and Tracking Links with pooled inventory) - name: Statistics description: "" - name: Stored Free Trial Links description: Instant APIs for retrieving stored free trial links from the OnlyFansAPI Cache (free, no credits used) - name: Stored Shared Free Trial Links description: Instant APIs for retrieving stored shared Free Trial Links from the OnlyFansAPI Cache (free, no credits used) - name: Stored Shared Tracking Links description: Instant APIs for retrieving stored shared Tracking Links (campaigns) from the OnlyFansAPI Cache (free, no credits used) - name: Stored Tracking Links description: Instant APIs for retrieving stored tracking links from the OnlyFansAPI Cache (free, no credits used) - name: Stories description: APIs for managing OnlyFans stories - name: Story Highlights description: APIs for managing OnlyFans story highlights - name: Subscription Bundles description: "" - name: Tracking Links description: APIs for managing tracking links - name: Transactions description: APIs for managing OnlyFans transactions - name: User List Collections description: "" - name: Users description: APIs for fetching OnlyFans users - name: Webhooks description: "" paths: /api/{account}/users/list: parameters: - in: path name: account description: The Account ID example: acct_XXXXXXXXXXXXXXX required: true schema: type: string get: summary: Mass-List User Details operationId: massListUserDetails description: Save on credits by getting up to 10 user details with a single request. User details are retrieved using the current `{account}` so fields like `subscribedOnData` which include potential subscription details will be included. parameters: - in: query name: ids description: Comma-separated list of user IDs (max. 10 IDs). Must be at least 1 character. example: 12412412,36139491,1858349 required: true schema: type: string description: Comma-separated list of user IDs (max. 10 IDs). Must be at least 1 character. example: 12412412,36139491,1858349 responses: "200": description: "" content: application/json: schema: type: object example: data: "1000000": view: f avatar: https://example.com/redacted.jpg avatarThumbs: c50: https://example.com/redacted.jpg c144: https://example.com/redacted.jpg header: null headerSize: null headerThumbs: null id: 1000000 name: Example User username: example_user canLookStory: true canCommentStory: true hasNotViewedStory: false isVerified: true canPayInternal: true hasScheduledStream: false hasStream: false hasStories: false tipsEnabled: false tipsTextEnabled: true tipsMin: 5 tipsMinInternal: 1 tipsMax: 200 canEarn: true canAddSubscriber: false subscribePrice: 0 displayName: Example User notice: "" isPaywallRequired: true isActive: true isRestricted: false canRestrict: true subscribedBy: true subscribedByExpire: false subscribedByExpireDate: 2024-01-01T00:00:00+00:00 subscribedByAutoprolong: false subscribedIsExpiredNow: false currentSubscribePrice: 0 subscribedOn: null subscribedOnExpiredNow: true subscribedOnDuration: 1 month listsStates: - id: redacted_id type: muted name: Example User hasUser: false canAddUser: true cannotAddUserReason: null - id: redacted_id type: fans name: Example User hasUser: false canAddUser: false cannotAddUserReason: null - id: redacted_id type: following name: Example User hasUser: true canAddUser: false cannotAddUserReason: ALREADY_EXISTS - id: redacted_id type: recent name: Example User hasUser: false canAddUser: false cannotAddUserReason: SYSTEM_LIST - id: redacted_id type: friends name: Example User hasUser: false canAddUser: true cannotAddUserReason: null - id: 1000000 type: custom name: Example User hasUser: true canAddUser: false cannotAddUserReason: ALREADY_EXISTS - id: 1000000 type: custom name: Example User hasUser: true canAddUser: false cannotAddUserReason: ALREADY_EXISTS - id: redacted_id type: rebill_off name: Example User hasUser: false canAddUser: false cannotAddUserReason: null - id: redacted_id type: rebill_on name: Example User hasUser: false canAddUser: false cannotAddUserReason: null - id: redacted_id type: tagged name: Example User hasUser: false canAddUser: false cannotAddUserReason: SYSTEM_LIST joinDate: 2024-01-01T00:00:00+00:00 isReferrerAllowed: true about: "" isMarkdownDisabledForAbout: false website: null wishlist: null location: null postsCount: 0 archivedPostsCount: 0 privateArchivedPostsCount: 0 photosCount: 0 videosCount: 0 audiosCount: 0 mediasCount: 0 lastSeen: 2024-01-01T00:00:00+00:00 favoritesCount: 0 favoritedCount: 0 showPostsInFeed: true canReceiveChatMessage: true isPerformer: true isRealPerformer: true isSpotifyConnected: false subscribersCount: null hasPinnedPosts: false hasLabels: false canChat: true avatarHeaderConverterUpload: true isPrivateRestriction: false showSubscribersCount: false showMediaCount: true subscribedByData: price: 0 newPrice: 0 regularPrice: 0 subscribePrice: 0 discountPercent: 0 discountPeriod: 1 subscribeAt: 2024-01-01T00:00:00+00:00 expiredAt: 2024-01-01T00:00:00+00:00 renewedAt: null discountFinishedAt: null discountStartedAt: null status: Set to Expire isMuted: false unsubscribeReason: Redacted duration: 6 months showPostsInFeed: true subscribes: - id: 1000000 userId: 1000000 subscriberId: 1000000 date: 2024-01-01T00:00:00+00:00 duration: 3652 startDate: 2024-01-01T00:00:00+00:00 expireDate: 2024-01-01T00:00:00+00:00 cancelDate: null price: 0 regularPrice: 0 discount: 0 earningId: 0 action: subscribe type: regular offerStart: null offerEnd: null isCurrent: true - id: 1000000 userId: 1000000 subscriberId: 1000000 date: 2024-01-01T00:00:00+00:00 duration: 3652 startDate: 2024-01-01T00:00:00+00:00 expireDate: 2024-01-01T00:00:00+00:00 cancelDate: null price: 0 regularPrice: 0 discount: 0 earningId: 0 action: prolong type: regular offerStart: null offerEnd: null isCurrent: true hasActivePaidSubscriptions: false subscribedOnData: price: 3.9 newPrice: 12.99 regularPrice: 12.99 subscribePrice: 12.99 discountPercent: 0 discountPeriod: 1 subscribeAt: 2024-01-01T00:00:00+00:00 expiredAt: 2024-01-01T00:00:00+00:00 renewedAt: null discountFinishedAt: null discountStartedAt: null status: null isMuted: false unsubscribeReason: Redacted duration: 8 months tipsSumm: 0 subscribesSumm: 0 messagesSumm: 0 postsSumm: 0 streamsSumm: 0 totalSumm: 0 subscribes: [] hasActivePaidSubscriptions: false canCreatePromotion: false canCreateTrial: false isAdultContent: false canTrialSend: true hasLinks: false hasFriends: true firstPublishedPostDate: 2024-01-01T00:00:00+00:00 isSpringConnected: false isFriend: false isBlocked: false canReport: true canUnsubscribe: true isPendingAutoprolong: false _meta: _credits: used: 1 balance: 380044 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: object properties: "1000000": type: object properties: view: type: string example: f avatar: type: string example: https://example.com/redacted.jpg avatarThumbs: type: object properties: c50: type: string example: https://example.com/redacted.jpg c144: type: string example: https://example.com/redacted.jpg header: type: string example: null nullable: true headerSize: type: string example: null nullable: true headerThumbs: type: string example: null nullable: true id: type: integer example: 1000000 name: type: string example: Example User username: type: string example: example_user canLookStory: type: boolean example: true canCommentStory: type: boolean example: true hasNotViewedStory: type: boolean example: false isVerified: type: boolean example: true canPayInternal: type: boolean example: true hasScheduledStream: type: boolean example: false hasStream: type: boolean example: false hasStories: type: boolean example: false tipsEnabled: type: boolean example: false tipsTextEnabled: type: boolean example: true tipsMin: type: integer example: 5 tipsMinInternal: type: integer example: 1 tipsMax: type: integer example: 200 canEarn: type: boolean example: true canAddSubscriber: type: boolean example: false subscribePrice: type: integer example: 0 displayName: type: string example: Example User notice: type: string example: "" isPaywallRequired: type: boolean example: true isActive: type: boolean example: true isRestricted: type: boolean example: false canRestrict: type: boolean example: true subscribedBy: type: boolean example: true subscribedByExpire: type: boolean example: false subscribedByExpireDate: type: string example: 2024-01-01T00:00:00+00:00 subscribedByAutoprolong: type: boolean example: false subscribedIsExpiredNow: type: boolean example: false currentSubscribePrice: type: integer example: 0 subscribedOn: type: string example: null nullable: true subscribedOnExpiredNow: type: boolean example: true subscribedOnDuration: type: string example: 1 month listsStates: type: array example: - id: redacted_id type: muted name: Example User hasUser: false canAddUser: true cannotAddUserReason: null - id: redacted_id type: fans name: Example User hasUser: false canAddUser: false cannotAddUserReason: null - id: redacted_id type: following name: Example User hasUser: true canAddUser: false cannotAddUserReason: ALREADY_EXISTS - id: redacted_id type: recent name: Example User hasUser: false canAddUser: false cannotAddUserReason: SYSTEM_LIST - id: redacted_id type: friends name: Example User hasUser: false canAddUser: true cannotAddUserReason: null - id: 1000000 type: custom name: Example User hasUser: true canAddUser: false cannotAddUserReason: ALREADY_EXISTS - id: 1000000 type: custom name: Example User hasUser: true canAddUser: false cannotAddUserReason: ALREADY_EXISTS - id: redacted_id type: rebill_off name: Example User hasUser: false canAddUser: false cannotAddUserReason: null - id: redacted_id type: rebill_on name: Example User hasUser: false canAddUser: false cannotAddUserReason: null - id: redacted_id type: tagged name: Example User hasUser: false canAddUser: false cannotAddUserReason: SYSTEM_LIST items: type: object properties: id: type: string example: redacted_id type: type: string example: muted name: type: string example: Example User hasUser: type: boolean example: false canAddUser: type: boolean example: true cannotAddUserReason: type: string example: null nullable: true joinDate: type: string example: 2024-01-01T00:00:00+00:00 isReferrerAllowed: type: boolean example: true about: type: string example: "" isMarkdownDisabledForAbout: type: boolean example: false website: type: string example: null nullable: true wishlist: type: string example: null nullable: true location: type: string example: null nullable: true postsCount: type: integer example: 0 archivedPostsCount: type: integer example: 0 privateArchivedPostsCount: type: integer example: 0 photosCount: type: integer example: 0 videosCount: type: integer example: 0 audiosCount: type: integer example: 0 mediasCount: type: integer example: 0 lastSeen: type: string example: 2024-01-01T00:00:00+00:00 favoritesCount: type: integer example: 0 favoritedCount: type: integer example: 0 showPostsInFeed: type: boolean example: true canReceiveChatMessage: type: boolean example: true isPerformer: type: boolean example: true isRealPerformer: type: boolean example: true isSpotifyConnected: type: boolean example: false subscribersCount: type: string example: null nullable: true hasPinnedPosts: type: boolean example: false hasLabels: type: boolean example: false canChat: type: boolean example: true avatarHeaderConverterUpload: type: boolean example: true isPrivateRestriction: type: boolean example: false showSubscribersCount: type: boolean example: false showMediaCount: type: boolean example: true subscribedByData: type: object properties: price: type: integer example: 0 newPrice: type: integer example: 0 regularPrice: type: integer example: 0 subscribePrice: type: integer example: 0 discountPercent: type: integer example: 0 discountPeriod: type: integer example: 1 subscribeAt: type: string example: 2024-01-01T00:00:00+00:00 expiredAt: type: string example: 2024-01-01T00:00:00+00:00 renewedAt: type: string example: null nullable: true discountFinishedAt: type: string example: null nullable: true discountStartedAt: type: string example: null nullable: true status: type: string example: Set to Expire isMuted: type: boolean example: false unsubscribeReason: type: string example: Redacted duration: type: string example: 6 months showPostsInFeed: type: boolean example: true subscribes: type: array example: - id: 1000000 userId: 1000000 subscriberId: 1000000 date: 2024-01-01T00:00:00+00:00 duration: 3652 startDate: 2024-01-01T00:00:00+00:00 expireDate: 2024-01-01T00:00:00+00:00 cancelDate: null price: 0 regularPrice: 0 discount: 0 earningId: 0 action: subscribe type: regular offerStart: null offerEnd: null isCurrent: true - id: 1000000 userId: 1000000 subscriberId: 1000000 date: 2024-01-01T00:00:00+00:00 duration: 3652 startDate: 2024-01-01T00:00:00+00:00 expireDate: 2024-01-01T00:00:00+00:00 cancelDate: null price: 0 regularPrice: 0 discount: 0 earningId: 0 action: prolong type: regular offerStart: null offerEnd: null isCurrent: true items: type: object properties: id: type: integer example: 1000000 userId: type: integer example: 1000000 subscriberId: type: integer example: 1000000 date: type: string example: 2024-01-01T00:00:00+00:00 duration: type: integer example: 3652 startDate: type: string example: 2024-01-01T00:00:00+00:00 expireDate: type: string example: 2024-01-01T00:00:00+00:00 cancelDate: type: string example: null nullable: true price: type: integer example: 0 regularPrice: type: integer example: 0 discount: type: integer example: 0 earningId: type: integer example: 0 action: type: string example: subscribe type: type: string example: regular offerStart: type: string example: null nullable: true offerEnd: type: string example: null nullable: true isCurrent: type: boolean example: true hasActivePaidSubscriptions: type: boolean example: false subscribedOnData: type: object properties: price: type: number example: 3.9 newPrice: type: number example: 12.99 regularPrice: type: number example: 12.99 subscribePrice: type: number example: 12.99 discountPercent: type: integer example: 0 discountPeriod: type: integer example: 1 subscribeAt: type: string example: 2024-01-01T00:00:00+00:00 expiredAt: type: string example: 2024-01-01T00:00:00+00:00 renewedAt: type: string example: null nullable: true discountFinishedAt: type: string example: null nullable: true discountStartedAt: type: string example: null nullable: true status: type: string example: null nullable: true isMuted: type: boolean example: false unsubscribeReason: type: string example: Redacted duration: type: string example: 8 months tipsSumm: type: integer example: 0 subscribesSumm: type: integer example: 0 messagesSumm: type: integer example: 0 postsSumm: type: integer example: 0 streamsSumm: type: integer example: 0 totalSumm: type: integer example: 0 subscribes: type: array example: [] hasActivePaidSubscriptions: type: boolean example: false canCreatePromotion: type: boolean example: false canCreateTrial: type: boolean example: false isAdultContent: type: boolean example: false canTrialSend: type: boolean example: true hasLinks: type: boolean example: false hasFriends: type: boolean example: true firstPublishedPostDate: type: string example: 2024-01-01T00:00:00+00:00 isSpringConnected: type: boolean example: false isFriend: type: boolean example: false isBlocked: type: boolean example: false canReport: type: boolean example: true canUnsubscribe: type: boolean example: true isPendingAutoprolong: type: boolean example: false _meta: type: object properties: _credits: type: object properties: used: type: integer example: 1 balance: type: integer example: 380044 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 ````