> ## Documentation Index > Fetch the complete documentation index at: https://docs.whop.com/llms.txt > Use this file to discover all available pages before exploring further. # List Social Accounts > Lists the social accounts linked to an account or user. The owner is passed as exactly one of account_id (a biz_ identifier) or user_id (a user_ identifier); an account-scoped API key defaults to its own account when neither is given. ## OpenAPI ````yaml /openapi/api-v1-native.yml get /social_accounts openapi: 3.1.0 info: title: Whop API description: >- Hand-written V1 endpoints. Merged into the GraphqlRestProxy-generated schema at build time. version: v1 servers: - url: https://{defaultHost} variables: defaultHost: default: api.whop.com/api/v1 security: [] paths: /social_accounts: parameters: - $ref: '#/components/parameters/ApiVersionDate' get: tags: - Social Accounts summary: List Social Accounts description: >- Lists the social accounts linked to an account or user. The owner is passed as exactly one of account_id (a biz_ identifier) or user_id (a user_ identifier); an account-scoped API key defaults to its own account when neither is given. operationId: listSocialAccounts parameters: - name: account_id in: query required: false schema: type: string description: >- The Account that the social accounts are connected to. Provide either this or user_id. - name: user_id in: query required: false schema: type: string description: >- The User that the social accounts are connected to. Provide either this or account_id. - name: platform in: query required: false schema: type: string enum: - x - instagram - youtube - tiktok - facebook description: Only return social accounts for the platform that is specified. - name: verified in: query required: false schema: type: boolean description: Only return social accounts that are verified on the platform. - name: scopes in: query required: false schema: type: array items: type: string enum: - advertise description: Only return social accounts that have these scopes. - name: first in: query required: false schema: type: integer default: 20 maximum: 100 description: The number of social accounts to return. - name: after in: query required: false schema: type: string description: Cursor to fetch the page after (from page_info.end_cursor). - name: last in: query required: false schema: type: integer maximum: 100 description: The number of social accounts to return from the end of the range. - name: before in: query required: false schema: type: string description: Cursor to fetch the page before (from page_info.start_cursor). - name: order in: query required: false schema: type: string enum: - display_order - created_at default: display_order description: The field to sort social accounts by. - name: direction in: query required: false schema: type: string enum: - asc - desc default: asc description: Sort direction. responses: '200': description: filtered to accounts holding the requested scope content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/SocialAccount' page_info: type: object properties: has_next_page: type: boolean end_cursor: type: string nullable: true has_previous_page: type: boolean start_cursor: type: string nullable: true required: - has_next_page - end_cursor - has_previous_page - start_cursor required: - data - page_info '400': $ref: '#/components/responses/InvalidParameters' description: neither account_id nor user_id resolvable '401': $ref: '#/components/responses/Unauthorized' description: missing or invalid authentication security: - bearerAuth: - social_account:read components: parameters: ApiVersionDate: name: Api-Version-Date in: header required: false schema: type: string example: 2026-07-08-1 description: Pins the request to a dated API version. schemas: SocialAccount: type: object properties: id: type: string description: Unique identifier for the social account. platform: type: string description: The platform the social account exists on. enum: - x - instagram - youtube - tiktok - facebook example: x username: type: string description: The username of the social account on the platform. name: type: - string - 'null' description: The display name of the social account on the platform. url: type: string description: The URL where the social account can be accessed on the platform. profile_picture_url: type: - string - 'null' description: >- The URL where the profile picture of the social account can be accessed. verified: type: boolean description: Whether the social account is verified on the platform. external_id: type: - string - 'null' description: The platform-specific ID for this social account. scopes: type: array items: type: string description: >- Capabilities Whop retains specific to this social account. For example, Whop may request the ability to run advertisements that use this social account's identity, reflected by the presence of `advertise` in this value. required: - id - platform - username - name - url - profile_picture_url - verified - external_id - scopes V1ErrorResponse: type: object properties: error: type: object properties: type: type: string description: Machine-readable error code. message: type: string description: Human-readable error message. required: - type - message required: - error responses: InvalidParameters: description: Invalid Parameters content: application/json: schema: $ref: '#/components/schemas/V1ErrorResponse' Unauthorized: description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/V1ErrorResponse' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: auth-scheme description: >- An account API key, account scoped JWT, app API key, or user OAuth token. ````