> ## Documentation Index > Fetch the complete documentation index at: https://docs.ofauth.com/llms.txt > Use this file to discover all available pages before exploring further. # Get users by IDs > Get user profiles for multiple users by their IDs. Provide `userIds` as a comma-separated string or array, or use OnlyFans-style `t[]` / `m[]` query parameters. Maximum 10 user IDs per request. Returns an array of user profiles. **Permission Required:** `profile:read` ## OpenAPI ````yaml https://api.ofauth.com/openapi.json get /v2/access/users/list openapi: 3.1.0 info: title: OFAuth API version: 1.0.0 description: >- OFAuth API including Account, Connections, Link, Access, Dynamic Rules, Vault+, and Realtime webhook contracts contact: email: support@ofauth.com url: https://ofauth.com/ servers: - url: https://api.ofauth.com security: - ApiKey: [] tags: - name: Account description: Account management endpoints. - name: Connections description: Connection management endpoints. - name: Link description: Link authentication and session endpoints. - name: Access description: All Access related endpoints. - name: Analytics description: 'Access: charts, tops, and performance metrics.' - name: Earnings description: 'Access: earnings charts, transactions, and chargebacks.' - name: Messages description: 'Access: messaging, chats, queue, and mass messaging.' - name: Posts description: 'Access: create, edit, list, and manage posts.' - name: Promotions description: 'Access: promotions, trials, and bundles.' - name: Users description: 'Access: user profiles, subscriptions, and actions.' - name: Vault description: 'Access: vault folders, media, and management.' - name: Upload description: 'Access: media upload and processing.' - name: Self description: 'Access: authenticated account details and settings.' - name: Stories description: 'Access: stories listing and management.' - name: Subscriptions description: 'Access: subscription offers, discounts, and management.' - name: Realtime description: >- Realtime webhook delivery contracts, including relayed OnlyFans websocket events. - name: Dynamic Rules description: Dynamic signing rules operations. - name: Vault+ description: Vault+ caching and management. externalDocs: description: OFAuth Developer Documentation url: https://docs.ofauth.com paths: /v2/access/users/list: get: tags: - Users summary: Get users by IDs description: >- Get user profiles for multiple users by their IDs. Provide `userIds` as a comma-separated string or array, or use OnlyFans-style `t[]` / `m[]` query parameters. Maximum 10 user IDs per request. Returns an array of user profiles. **Permission Required:** `profile:read` parameters: - schema: type: string description: Comma-separated user IDs to fetch required: false description: Comma-separated user IDs to fetch name: userIds in: query - schema: type: string description: Comma-separated OnlyFans t[] user IDs required: false description: Comma-separated OnlyFans t[] user IDs name: t in: query - schema: type: string description: Comma-separated OnlyFans m[] user IDs required: false description: Comma-separated OnlyFans m[] user IDs name: m in: query responses: '200': description: Successful response content: application/json: schema: type: object properties: users: type: array items: type: object properties: id: type: number username: type: string name: type: string isVerified: type: boolean avatar: type: string nullable: true avatarThumbs: type: object nullable: true properties: c50: type: string c144: type: string required: - c50 - c144 lists: type: array items: type: object properties: id: anyOf: - type: string - type: number type: type: string name: type: string required: - id - type - name displayName: type: string notice: type: string about: type: string nullable: true isMarkdownDisabledForAbout: type: boolean website: type: string nullable: true wishlist: type: string nullable: true location: type: string nullable: true header: type: string nullable: true headerSize: type: object nullable: true properties: width: type: number height: type: number required: - width - height headerThumbs: type: object nullable: true properties: w480: type: string w760: type: string required: - w480 - w760 subscribersCount: type: number nullable: true postsCount: type: number archivedPostsCount: type: number privateArchivedPostsCount: type: number photosCount: type: number videosCount: type: number audiosCount: type: number mediasCount: type: number favoritesCount: type: number favoritedCount: type: number joinDate: type: string lastSeen: type: string nullable: true subscribedBy: type: boolean subscribedByExpire: type: boolean nullable: true subscribedByExpireDate: type: string nullable: true subscribedByAutoprolong: type: boolean nullable: true subscribedIsExpiredNow: type: boolean nullable: true subscribedByData: type: object nullable: true properties: price: type: number newPrice: type: number regularPrice: type: number subscribePrice: type: number discountPercent: type: number discountPeriod: type: number subscribeAt: type: string expiredAt: type: string renewedAt: type: string nullable: true discountFinishedAt: type: string nullable: true discountStartedAt: type: string nullable: true status: type: string nullable: true isMuted: type: boolean unsubscribeReason: type: string duration: type: string hasActivePaidSubscriptions: type: boolean showPostsInFeed: type: boolean subscribes: type: array items: type: object properties: id: type: number userId: type: number subscriberId: type: number date: type: string duration: type: number startDate: type: string expireDate: type: string cancelDate: type: string nullable: true price: type: number regularPrice: type: number discount: type: number earningId: type: number action: type: string type: type: string offerStart: type: string nullable: true offerEnd: type: string nullable: true isCurrent: type: boolean required: - id - userId - subscriberId - date - duration - startDate - expireDate - cancelDate - price - regularPrice - discount - earningId - action - type - offerStart - offerEnd - isCurrent subscribedOn: type: boolean subscribedOnExpiredNow: type: boolean subscribedOnDuration: type: string subscribedOnData: type: object nullable: true properties: price: type: number newPrice: type: number regularPrice: type: number subscribePrice: type: number discountPercent: type: number discountPeriod: type: number subscribeAt: type: string expiredAt: type: string renewedAt: type: string nullable: true discountFinishedAt: type: string nullable: true discountStartedAt: type: string nullable: true status: type: string nullable: true isMuted: type: boolean unsubscribeReason: type: string duration: type: string hasActivePaidSubscriptions: type: boolean subscribes: type: array items: type: object properties: id: type: number userId: type: number subscriberId: type: number date: type: string duration: type: number startDate: type: string expireDate: type: string cancelDate: type: string nullable: true price: type: number regularPrice: type: number discount: type: number earningId: type: number action: type: string type: type: string offerStart: type: string nullable: true offerEnd: type: string nullable: true isCurrent: type: boolean required: - id - userId - subscriberId - date - duration - startDate - expireDate - cancelDate - price - regularPrice - discount - earningId - action - type - offerStart - offerEnd - isCurrent tipsSumm: type: number subscribesSumm: type: number messagesSumm: type: number postsSumm: type: number streamsSumm: type: number totalSumm: type: number subscribePrice: type: number currentSubscribePrice: type: number nullable: true canAddSubscriber: type: boolean tipsEnabled: type: boolean tipsTextEnabled: type: boolean tipsMin: type: number tipsMinInternal: type: number tipsMax: type: number canLookStory: type: boolean canCommentStory: type: boolean hasNotViewedStory: type: boolean hasStories: type: boolean isRestricted: type: boolean canRestrict: type: boolean isBlocked: type: boolean canReport: type: boolean canUnsubscribe: type: boolean isPendingAutoprolong: type: boolean isPerformer: type: boolean isRealPerformer: type: boolean canReceiveChatMessage: type: boolean canChat: type: boolean showPostsInFeed: type: boolean hasPinnedPosts: type: boolean hasLabels: type: boolean isPrivateRestriction: type: boolean showSubscribersCount: type: boolean showMediaCount: type: boolean isReferrerAllowed: type: boolean canCreatePromotion: type: boolean canCreateTrial: type: boolean isAdultContent: type: boolean canTrialSend: type: boolean isFriend: type: boolean hasScheduledStream: type: boolean hasStream: type: boolean canPayInternal: type: boolean required: - id - username - name - isVerified - avatar - lists required: - users '400': description: Bad Request '401': description: Unauthorized '403': description: Forbidden '429': description: Rate Limit Exceeded '500': description: Internal Server Error '502': description: Bad Gateway deprecated: true security: - ApiKey: [] ConnectionId: [] components: securitySchemes: ApiKey: type: apiKey name: apiKey in: header description: >- Your OFAuth [API key](/quickstart#2-copy-your-api-key) for authenticating requests. ConnectionId: type: apiKey name: x-connection-id in: header description: >- Requires a [connection](/guides/connections) via the x-connection-id header. ````