> Portal Navigation: > > - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version. > - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages). > - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`). > - Top-level index of all portals: https://dev.wix.com/docs/llms.txt > - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt # QuerySiteContributors # Package: userManagement # Namespace: SiteRolesManagementService # Method link: https://dev.wix.com/docs/api-reference/account-level/user-management/contributors/query-site-contributors.md ## Permission Scopes: Manage Contributors: SCOPE.DC-IDENTITY.MANAGE-CONTRIBUTORS ## Introduction Retrieves a list of contributors for the specified site, given the provided filters. Returns contributor account IDs and account owner IDs that match the specified filters. --- ## REST API ### Schema ``` Method: querySiteContributors Description: Retrieves a list of contributors for the specified site, given the provided filters. Returns contributor account GUIDs and account owner GUIDs that match the specified filters. URL: https://www.wixapis.com/roles-management/v2/contributors/query Method: GET Method parameters: param name: filter | type: QuerySiteContributorsFilter - name: policyIds | type: array | description: Role GUIDs (referred to here as policy GUIDs) to filter by. Returns only contributors with at least one of the specified roles. See [Roles and Permissions](https://support.wix.com/en/article/roles-permissions-overview) for available roles. - name: locationIds | type: array | description: Location GUIDs to filter by. Returns only contributors with assignments to at least one of the specified locations. Return type: QuerySiteContributorsResponse - name: contributors | type: array | description: List of site contributors matching the filter criteria. - name: accountId | type: string | description: Contributor's account GUID. - name: accountOwnerId | type: string | description: User GUID of the owner of the account that the contributor belongs to. ``` ### Examples ### Get Roles Info ```curl curl -X GET \ 'https://www.wixapis.com/roles-management/v2/contributors/query' \ -H 'Content-Type: application/json' \ -H 'Authorization: ' \ -d '{ "filter": { "policyIds": [ "6600344420111308827" ] } }' ``` --- ## JavaScript SDK ### Schema ``` Method: wixClientAdmin.userManagement.SiteRolesManagementService.querySiteContributors(options) Description: Retrieves a list of contributors for the specified site, given the provided filters. Returns contributor account GUIDs and account owner GUIDs that match the specified filters. Method parameters: param name: options | type: QuerySiteContributorsOptions none - name: filter | type: QuerySiteContributorsFilter | description: Filter object for narrowing search results. - name: policyIds | type: array | description: Role GUIDs (referred to here as policy GUIDs) to filter by. Returns only contributors with at least one of the specified roles. See [Roles and Permissions](https://support.wix.com/en/article/roles-permissions-overview) for available roles. - name: locationIds | type: array | description: Location GUIDs to filter by. Returns only contributors with assignments to at least one of the specified locations. Return type: PROMISE - name: contributors | type: array | description: List of site contributors matching the filter criteria. - name: accountId | type: string | description: Contributor's account GUID. - name: accountOwnerId | type: string | description: User GUID of the owner of the account that the contributor belongs to. ``` ### Examples ### Query the contributor on a site with an API key ```javascript import { createClient, ApiKeyStrategy } from "@wix/sdk"; import { contributors } from "@wix/user-management"; const wixClient = createClient({ modules: { contributors }, auth: ApiKeyStrategy({ siteId: "MY-SITE-ID", apiKey: "MY-API-KEY", }), }); async function querySiteContributors(options) { const response = await contributors.querySiteContributors(options); } ``` ### querySiteContributors (self-hosted) Self-hosted SDK calls require you to [create a client](https://dev.wix.com/docs/sdk/articles/work-with-the-sdk/about-the-wix-client.md). ```javascript import { createClient } from '@wix/sdk'; import { contributors } from '@wix/user-management'; // Import the auth strategy for the relevant access type // Import the relevant host module if needed const myWixClient = createClient ({ modules: { contributors }, // Include the auth strategy and host as relevant }); async function querySiteContributors(options) { const response = await myWixClient.contributors.querySiteContributors(options); }; ``` ---