> 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: sites

# Namespace: SiteRolesManagementService

# Method link: https://dev.wix.com/docs/api-reference/account-level/user-management/sites/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<string> | 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.  | validation: maxItems 20
        - name: locationIds | type: array<string> | description: Location GUIDs to filter by. Returns only contributors with assignments to at least one of the specified locations.  | validation: maxItems 20, format GUID
 Return type: QuerySiteContributorsResponse
  - name: contributors | type: array<ContributorV2> | 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: <AUTH>' \
-d '{
        "filter": {
          "policyIds": [
            "6600344420111308827"
          ]
        }
      }'
```

---

## JavaScript SDK

### Schema

```
 Method: wixClientAdmin.userManagement.contributors.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<string> | 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.  | validation: maxItems 20
           - name: locationIds | type: array<string> | description: Location GUIDs to filter by. Returns only contributors with assignments to at least one of the specified locations.  | validation: maxItems 20, format GUID
 Return type: PROMISE<QuerySiteContributorsResponse>
  - name: contributors | type: array<ContributorV2> | 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);
};
```

---