> 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

# QueryParticipants

# Package: onlinePrograms

# Namespace: ParticipantsService

# Method link: https://dev.wix.com/docs/api-reference/business-management/online-programs/participants/query-participants.md

## Permission Scopes:
Manage Online Programs: SCOPE.CHALLENGES.MANAGE

## Introduction

Retrieves a list of up to 50 participants, given the provided paging, filtering, and sorting.

Query Participants runs with these defaults, which you can override:

- `createdDate` is sorted in `DESC` order.
- `paging.limit` is `50`.
- `paging.offset` is `0`.

To learn about working with Query methods, see [API Query Language](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/data-retrieval/about-the-wix-api-query-language.md), [Sorting and Paging](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/data-retrieval/about-sorting-and-paging.md), and [Field Projection](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/data-retrieval/about-field-projection.md).

---

## REST API

### Schema

```
 Method: queryParticipants
 Description: Retrieves a list of up to 50 participants, given the provided paging, filtering, and sorting.  Query Participants runs with these defaults, which you can override:  - `createdDate` is sorted in `DESC` order. - `paging.limit` is `50`. - `paging.offset` is `0`.  To learn about working with Query methods, see [API Query Language](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/data-retrieval/about-the-wix-api-query-language.md), [Sorting and Paging](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/data-retrieval/about-sorting-and-paging.md), and [Field Projection](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/data-retrieval/about-field-projection.md).
 URL: https://www.wixapis.com/online-programs/v3/participants/query
 Method: POST
 Method parameters:
   param name: fields | type: array<fields> | description: Array of conditional fields to include in the response. Use `RequestedFields.PROGRESS` to include the `progress` field, which isn't returned by default.  | validation: maxItems 1
                 - enum:
                 -     PROGRESS: Request the progress field to be calculated and included in the response.
   param name: query | type: QueryV2    
     - name: cursorPaging | type: CursorPaging | description: Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`.  
        - name: limit | type: integer | description: Maximum number of items to return in the results.  | validation: minimum 0, maximum 100, format int32
        - name: cursor | type: string | description: Pointer to the next or previous page in the list of results.  Pass the relevant cursor token from the `pagingMetadata` object in the previous call's response. Not relevant for the first request.  | validation: maxLength 16000
        - name: filter | type: object | description: Filter object.  Learn more about [filtering](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language.md#filters).  
        - name: sort | type: array<Sorting> | description: Sort object.  Learn more about [sorting](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language.md#sorting).  | validation: maxItems 100
           - name: fieldName | type: string | description: Name of the field to sort by.  | validation: maxLength 512
           - name: order | type: SortOrder | description: Sort order.  
                 - enum: ASC, DESC
        - name: fields | type: array<string> | description: Array of projected fields. A list of specific field names to return. If `fieldsets` are also specified, the union of `fieldsets` and `fields` is returned.  | validation: maxItems 100, maxLength 1000
        - name: fieldsets | type: array<string> | description: Array of named, predefined sets of projected fields. A array of predefined named sets of fields to be returned. Specifying multiple `fieldsets` will return the union of fields from all sets. If `fields` are also specified, the union of `fieldsets` and `fields` is returned.  | validation: maxItems 100, maxLength 1000
 Query fields:
   - field: id | operators: $eq, $in | sort: ASC, DESC | aggregatable: undefined | searchable: undefined
   - field: enrollmentStatus | operators: $eq, $in | sort: ASC, DESC | aggregatable: undefined | searchable: undefined
   - field: progressStatus | operators: $eq, $in | sort: ASC, DESC | aggregatable: undefined | searchable: undefined
   - field: memberId | operators: $eq, $in | sort: none | aggregatable: undefined | searchable: undefined
   - field: programId | operators: $eq | sort: none | aggregatable: undefined | searchable: undefined
   - field: createdDate | operators: $eq, $ne, $in, $exists, $gt, $gte, $lt, $lte | sort: ASC, DESC | aggregatable: undefined | searchable: undefined
   - field: lastActivityDate | operators: $eq, $ne, $in, $exists, $gt, $gte, $lt, $lte | sort: ASC, DESC | aggregatable: undefined | searchable: undefined
   - field: progress.totalStepsCompleted | operators: $eq, $ne, $in, $exists, $gt, $gte, $lt, $lte | sort: ASC, DESC | aggregatable: undefined | searchable: undefined
   - field: enrollmentInfo.startDate | operators: $gte, $lte, $gt, $lt | sort: ASC, DESC | aggregatable: undefined | searchable: undefined
 Return type: QueryParticipantsResponse
  - name: participants | type: array<Participant> | description: List of participants matching the query.  
     - name: id | type: string | description: Participant GUID.  | read-only: true | validation: format GUID
     - name: revision | type: string | description: Revision number, which increments by 1 each time the participant is updated. To prevent conflicting changes, the current revision must be specified when updating the participant.  Ignored when creating a participant.  | read-only: true | validation: format int64
     - name: createdDate | type: string | description: Date and time the participant was created.  | read-only: true | validation: format date-time
     - name: updatedDate | type: string | description: Date and time the participant was updated.  | read-only: true | validation: format date-time
     - name: memberId | type: string | description: Member GUID of the participant on the site.  | read-only: true | validation: format GUID
     - name: programId | type: string | description: GUID of the program the participant is enrolled in.  | read-only: true | validation: format GUID
     - name: progress | type: Progress | description: Program completion progress. This field is conditional and must be explicitly requested using the `fields` parameter.  | read-only: true 
        - name: totalStepsCompleted | type: integer | description: Number of program steps completed by member.  | validation: minimum 0
        - name: totalStepsAvailable | type: integer | description: Total number of program steps available to resolve.  | validation: minimum 0
        - name: completionPercentage | type: number | description: Participant's completion percentage. For participants who completed the program, this is `100.0`. Otherwise, it's calculated as (`totalStepsCompleted` / `totalStepsAvailable`) * 100, capped at `100`, and rounded to 1 decimal place.  | validation: minimum 0, maximum 100
     - name: certificateInfo | type: CertificateInfo | description: Information about the participant's certificate.  Returned only when a certificate has been issued to the participant.  | read-only: true 
        - name: issueDate | type: string | description: Date when the certificate was issued (UTC).  | read-only: true | validation: format date-time
     - name: member | type: Member | description: Snapshot of the site member identified by `memberId`, copied from the Members API. It isn't the authoritative member record.  | read-only: true 
        - name: firstName | type: string | description: First name of the site member.  Returned only when the member has provided it in their profile.  | read-only: true | validation: maxLength 1000
        - name: lastName | type: string | description: Last name of the site member.  Returned only when the member has provided it in their profile.  | read-only: true | validation: maxLength 1000
        - name: email | type: string | description: Email of the site member.  Returned only when the member has provided it in their profile.  | read-only: true | validation: format EMAIL
        - name: contactId | type: string | description: Contact GUID for accessing additional member information with the Contacts API, such as phone numbers, addresses, and custom fields.  Returned only when the member has provided this information in their profile.  | read-only: true | validation: format GUID
        - name: nickname | type: string | description: Member nickname.  Returned only when the member has provided it in their profile.  | read-only: true | validation: maxLength 1000
        - name: profileImageUrl | type: string | description: Profile image URL of the site member.  | read-only: true | validation: format WEB_URL
     - name: lastActivityDate | type: string | description: Last activity date of the participant in the program (can either be status change or step resolution).  | read-only: true | validation: format date-time
     - name: enrollmentStatus | type: EnrollmentStatus | description: Participant's enrollment status in the program.  | read-only: true 
         - enum:
         -     JOINED: Participant is actively enrolled in the program.
         -     SUSPENDED: Enrollment temporarily suspended due to payment issues.
         -     AUTO_REMOVED: Automatically removed via a Wix Automations workflow.
         -     REMOVED: Removed from the program by the site owner.
         -     LEFT: Participant voluntarily left the program.
     - name: progressStatus | type: ProgressStatus | description: Participant's progress status in the program.  | read-only: true 
         - enum:
         -     NOT_STARTED: Enrolled but no steps completed yet.
         -     IN_PROGRESS: At least one step completed but program not yet finished.
         -     COMPLETED: Participant successfully completed the program.
         -     FAILED: Participant failed to complete the program within the deadline.
         -     NOT_APPLICABLE: Progress tracking isn't applicable because the participant left, was removed, or was auto-removed.
     - name: enrollmentInfo | type: EnrollmentInfo | description: Additional information about the participant's enrollment and completion timeframe in the program.  
        - ONE-OF: 
           - name: singlePaymentDetails | type: SinglePaymentDetails | description: Details about a Single Payment enrollment.  
              - name: paymentOrderId | type: string | description: GUID of the cashier order which was used to pay for joining the program.  | validation: format GUID, immutable
              - name: offlineTransactionId | type: string | description: GUID of the offline transaction.  Available only when the participant paid with an offline payment method, such as cash or check.  | validation: format GUID, immutable
           - name: paidPlanDetails | type: PaidPlanDetails | description: Details about a Paid Plan enrollment.  
              - name: paidPlanId | type: string | description: GUID of the Paid Plan for which member has paid to join the program.  | validation: format GUID, immutable
           - name: freeCouponDetails | type: FreeCouponDetails | description: Details about a Free Coupon enrollment.  
              - name: freeCouponId | type: string | description: GUID of the coupon which was applied and gave 100% discount to join the program for free.  | validation: format GUID, immutable
        - name: timeZone | type: string | description: Time zone of the site when the participant was enrolled in the program, in IANA timezone format (e.g., "America/New_York").  | read-only: true | validation: maxLength 50
        - name: startDate | type: string | description: Date when the participant's program timeline begins, in `YYYY-MM-DD` format. If the program's `timeline.startDate` is set, this is that date. Otherwise, it's the local calendar date when the participant is created, based on the site's time zone.  | read-only: true | validation: format LOCAL_DATE
        - name: pricingType | type: PricingType | description: Pricing type used for the participant's enrollment in the program.  
             - enum:
             -     FREE: Member joined a program that is configured as free to join, with no payment required.
             -     ADDED_MANUALLY: Member was added to the program by site owner.
             -     SINGLE_PAYMENT: Member paid once to join the program.
             -     PAID_PLAN: Member joined using a Pricing Plan.
             -     FREE_COUPON: Member joined a paid program using a coupon that provided 100% discount.
        - name: deadline | type: string | description: Date by which the participant must complete the program, in `YYYY-MM-DD` format.  Returned only when the program has a fixed end date, or a duration-based deadline calculated from the participant's start date.  | read-only: true | validation: format LOCAL_DATE
     - name: extendedFields | type: ExtendedFields | description: Custom field data for the participant object.  [Extended fields](https://dev.wix.com/docs/build-apps/develop-your-app/extensions/backend-extensions/schema-plugins/about-schema-plugin-extensions.md) must be configured in the app dashboard before they can be accessed with API calls.  
        - name: namespaces | type: object | description: Extended field data. Each key corresponds to the namespace of the app that created the extended fields. The value of each key is structured according to the schema defined when the extended fields were configured.  You can only access fields for which you have the appropriate permissions.  Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields.md).  | validation: format map
     - name: tags | type: Tags | description: Tags for categorizing and organizing participants.  
        - name: privateTags | type: TagList | description: Tags that require an additional permission in order to access them, typically restricted from site members and visitors.  
           - name: tagIds | type: array<string> | description: List of tag GUIDs.  | validation: maxItems 100, maxLength 5
        - name: publicTags | type: TagList | description: Tags that are exposed to anyone with access to the entity, including site members and visitors.  
  - name: pagingMetadata | type: PagingMetadataV2 | description: Paging metadata.  
     - name: count | type: integer | description: Number of items returned in the response.  | validation: format int32
     - name: offset | type: integer | description: Offset that was requested.  | validation: format int32
     - name: total | type: integer | description: Total number of items that match the query. Returned if offset paging is used and the `tooManyToCount` flag is not set.  | validation: format int32
     - name: tooManyToCount | type: boolean | description: Flag that indicates the server failed to calculate the `total` field.  
     - name: cursors | type: Cursors | description: Cursors to navigate through the result pages using `next` and `prev`. Returned if cursor paging is used.  
        - name: next | type: string | description: Cursor string pointing to the next page in the list of results.  | validation: maxLength 16000
        - name: prev | type: string | description: Cursor pointing to the previous page in the list of results.  | validation: maxLength 16000


```

### Examples

### Query participants by progress status
Queries participants with in-progress status for a specific program

```curl
curl -X POST \
'https://www.wixapis.com/online-programs/participants/v3/participants/query' \
-H 'Authorization: <AUTH>' \
-H 'Content-Type: application/json' \
-d '{
  "query": {
    "filter": {
      "$and": [
        {"programId": {"$eq": "5f2d6b0e-8f8f-4e6e-a1b1-6f6a8427c3d7"}},
        {"progressStatus": {"$eq": "IN_PROGRESS"}}
      ]
    },
    "sort": [{"fieldName": "createdDate", "order": "DESC"}],
    "paging": {"limit": 50}
  },
  "fields": ["PROGRESS"]
}'
```

---

## JavaScript SDK

### Schema

```
 Method: wixClientAdmin.onlinePrograms.participants.queryParticipants(query, options)
 Description: Retrieves a list of up to 50 participants, given the provided paging, filtering, and sorting.  Query Participants runs with these defaults, which you can override:  - `createdDate` is sorted in `DESC` order. - `paging.limit` is `50`. - `paging.offset` is `0`.  To learn about working with Query methods, see [API Query Language](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/data-retrieval/about-the-wix-api-query-language.md), [Sorting and Paging](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/data-retrieval/about-sorting-and-paging.md), and [Field Projection](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/data-retrieval/about-field-projection.md).
 # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present.
 Required parameters:  query
 Method parameters: 
   param name: options | type: QueryParticipantsOptions  none  
        - name: fields | type: array<RequestedFields> | description: Array of conditional fields to include in the response. Use `RequestedFields.PROGRESS` to include the `progress` field, which isn't returned by default.  | validation: maxItems 1
             - enum:
             -     PROGRESS: Request the progress field to be calculated and included in the response.
   param name: query | type: ParticipantQuery   | required: true 
     - name: cursorPaging | type: CursorPaging | description: Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`.  
        - name: limit | type: integer | description: Maximum number of items to return in the results.  | validation: minimum 0, maximum 100, format int32
        - name: cursor | type: string | description: Pointer to the next or previous page in the list of results.  Pass the relevant cursor token from the `pagingMetadata` object in the previous call's response. Not relevant for the first request.  | validation: maxLength 16000
        - name: filter | type: object | description: Filter object.  Learn more about [filtering](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language.md#filters).  
        - name: sort | type: array<Sorting> | description: Sort object.  Learn more about [sorting](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language.md#sorting).  | validation: maxItems 100
           - name: fieldName | type: string | description: Name of the field to sort by.  | validation: maxLength 512
           - name: order | type: SortOrder | description: Sort order.  
                 - enum: ASC, DESC
 Query fields:
   - field: _id | operators: $eq, $in | sort: ASC, DESC | aggregatable: undefined | searchable: undefined
   - field: enrollmentStatus | operators: $eq, $in | sort: ASC, DESC | aggregatable: undefined | searchable: undefined
   - field: progressStatus | operators: $eq, $in | sort: ASC, DESC | aggregatable: undefined | searchable: undefined
   - field: memberId | operators: $eq, $in | sort: none | aggregatable: undefined | searchable: undefined
   - field: programId | operators: $eq | sort: none | aggregatable: undefined | searchable: undefined
   - field: _createdDate | operators: $eq, $ne, $in, $exists, $gt, $gte, $lt, $lte | sort: ASC, DESC | aggregatable: undefined | searchable: undefined
   - field: lastActivityDate | operators: $eq, $ne, $in, $exists, $gt, $gte, $lt, $lte | sort: ASC, DESC | aggregatable: undefined | searchable: undefined
   - field: progress.totalStepsCompleted | operators: $eq, $ne, $in, $exists, $gt, $gte, $lt, $lte | sort: ASC, DESC | aggregatable: undefined | searchable: undefined
   - field: enrollmentInfo.startDate | operators: $gte, $lte, $gt, $lt | sort: ASC, DESC | aggregatable: undefined | searchable: undefined
 Return type: PROMISE<QueryParticipantsResponse>
  - name: participants | type: array<Participant> | description: List of participants matching the query.  
     - name: _id | type: string | description: Participant GUID.  | read-only: true | validation: format GUID
     - name: revision | type: string | description: Revision number, which increments by 1 each time the participant is updated. To prevent conflicting changes, the current revision must be specified when updating the participant.  Ignored when creating a participant.  | read-only: true | validation: format int64
     - name: _createdDate | type: Date | description: Date and time the participant was created.  | read-only: true 
     - name: _updatedDate | type: Date | description: Date and time the participant was updated.  | read-only: true 
     - name: memberId | type: string | description: Member GUID of the participant on the site.  | read-only: true | validation: format GUID
     - name: programId | type: string | description: GUID of the program the participant is enrolled in.  | read-only: true | validation: format GUID
     - name: progress | type: Progress | description: Program completion progress. This field is conditional and must be explicitly requested using the `fields` parameter.  | read-only: true 
        - name: totalStepsCompleted | type: integer | description: Number of program steps completed by member.  | validation: minimum 0
        - name: totalStepsAvailable | type: integer | description: Total number of program steps available to resolve.  | validation: minimum 0
        - name: completionPercentage | type: number | description: Participant's completion percentage. For participants who completed the program, this is `100.0`. Otherwise, it's calculated as (`totalStepsCompleted` / `totalStepsAvailable`) * 100, capped at `100`, and rounded to 1 decimal place.  | validation: minimum 0, maximum 100
     - name: certificateInfo | type: CertificateInfo | description: Information about the participant's certificate.  Returned only when a certificate has been issued to the participant.  | read-only: true 
        - name: issueDate | type: Date | description: Date when the certificate was issued (UTC).  | read-only: true 
     - name: member | type: Member | description: Snapshot of the site member identified by `memberId`, copied from the Members API. It isn't the authoritative member record.  | read-only: true 
        - name: firstName | type: string | description: First name of the site member.  Returned only when the member has provided it in their profile.  | read-only: true | validation: maxLength 1000
        - name: lastName | type: string | description: Last name of the site member.  Returned only when the member has provided it in their profile.  | read-only: true | validation: maxLength 1000
        - name: email | type: string | description: Email of the site member.  Returned only when the member has provided it in their profile.  | read-only: true | validation: format EMAIL
        - name: contactId | type: string | description: Contact GUID for accessing additional member information with the Contacts API, such as phone numbers, addresses, and custom fields.  Returned only when the member has provided this information in their profile.  | read-only: true | validation: format GUID
        - name: nickname | type: string | description: Member nickname.  Returned only when the member has provided it in their profile.  | read-only: true | validation: maxLength 1000
        - name: profileImageUrl | type: string | description: Profile image URL of the site member.  | read-only: true | validation: format WEB_URL
     - name: lastActivityDate | type: Date | description: Last activity date of the participant in the program (can either be status change or step resolution).  | read-only: true 
     - name: enrollmentStatus | type: EnrollmentStatus | description: Participant's enrollment status in the program.  | read-only: true 
         - enum:
         -     JOINED: Participant is actively enrolled in the program.
         -     SUSPENDED: Enrollment temporarily suspended due to payment issues.
         -     AUTO_REMOVED: Automatically removed via a Wix Automations workflow.
         -     REMOVED: Removed from the program by the site owner.
         -     LEFT: Participant voluntarily left the program.
     - name: progressStatus | type: ProgressStatus | description: Participant's progress status in the program.  | read-only: true 
         - enum:
         -     NOT_STARTED: Enrolled but no steps completed yet.
         -     IN_PROGRESS: At least one step completed but program not yet finished.
         -     COMPLETED: Participant successfully completed the program.
         -     FAILED: Participant failed to complete the program within the deadline.
         -     NOT_APPLICABLE: Progress tracking isn't applicable because the participant left, was removed, or was auto-removed.
     - name: enrollmentInfo | type: EnrollmentInfo | description: Additional information about the participant's enrollment and completion timeframe in the program.  
        - ONE-OF: 
           - name: singlePaymentDetails | type: SinglePaymentDetails | description: Details about a Single Payment enrollment.  
              - name: paymentOrderId | type: string | description: GUID of the cashier order which was used to pay for joining the program.  | validation: format GUID, immutable
              - name: offlineTransactionId | type: string | description: GUID of the offline transaction.  Available only when the participant paid with an offline payment method, such as cash or check.  | validation: format GUID, immutable
           - name: paidPlanDetails | type: PaidPlanDetails | description: Details about a Paid Plan enrollment.  
              - name: paidPlanId | type: string | description: GUID of the Paid Plan for which member has paid to join the program.  | validation: format GUID, immutable
           - name: freeCouponDetails | type: FreeCouponDetails | description: Details about a Free Coupon enrollment.  
              - name: freeCouponId | type: string | description: GUID of the coupon which was applied and gave 100% discount to join the program for free.  | validation: format GUID, immutable
        - name: timeZone | type: string | description: Time zone of the site when the participant was enrolled in the program, in IANA timezone format (e.g., "America/New_York").  | read-only: true | validation: maxLength 50
        - name: startDate | type: string | description: Date when the participant's program timeline begins, in `YYYY-MM-DD` format. If the program's `timeline.startDate` is set, this is that date. Otherwise, it's the local calendar date when the participant is created, based on the site's time zone.  | read-only: true | validation: format LOCAL_DATE
        - name: pricingType | type: PricingType | description: Pricing type used for the participant's enrollment in the program.  
             - enum:
             -     FREE: Member joined a program that is configured as free to join, with no payment required.
             -     ADDED_MANUALLY: Member was added to the program by site owner.
             -     SINGLE_PAYMENT: Member paid once to join the program.
             -     PAID_PLAN: Member joined using a Pricing Plan.
             -     FREE_COUPON: Member joined a paid program using a coupon that provided 100% discount.
        - name: deadline | type: string | description: Date by which the participant must complete the program, in `YYYY-MM-DD` format.  Returned only when the program has a fixed end date, or a duration-based deadline calculated from the participant's start date.  | read-only: true | validation: format LOCAL_DATE
     - name: extendedFields | type: ExtendedFields | description: Custom field data for the participant object.  [Extended fields](https://dev.wix.com/docs/build-apps/develop-your-app/extensions/backend-extensions/schema-plugins/about-schema-plugin-extensions.md) must be configured in the app dashboard before they can be accessed with API calls.  
        - name: namespaces | type: object | description: Extended field data. Each key corresponds to the namespace of the app that created the extended fields. The value of each key is structured according to the schema defined when the extended fields were configured.  You can only access fields for which you have the appropriate permissions.  Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields.md).  | validation: format map
     - name: tags | type: Tags | description: Tags for categorizing and organizing participants.  
        - name: privateTags | type: TagList | description: Tags that require an additional permission in order to access them, typically restricted from site members and visitors.  
           - name: tagIds | type: array<string> | description: List of tag GUIDs.  | validation: maxItems 100, maxLength 5
        - name: publicTags | type: TagList | description: Tags that are exposed to anyone with access to the entity, including site members and visitors.  
  - name: pagingMetadata | type: PagingMetadataV2 | description: Paging metadata.  
     - name: count | type: integer | description: Number of items returned in the response.  | validation: format int32
     - name: offset | type: integer | description: Offset that was requested.  | validation: format int32
     - name: total | type: integer | description: Total number of items that match the query. Returned if offset paging is used and the `tooManyToCount` flag is not set.  | validation: format int32
     - name: tooManyToCount | type: boolean | description: Flag that indicates the server failed to calculate the `total` field.  
     - name: cursors | type: Cursors | description: Cursors to navigate through the result pages using `next` and `prev`. Returned if cursor paging is used.  
        - name: next | type: string | description: Cursor string pointing to the next page in the list of results.  | validation: maxLength 16000
        - name: prev | type: string | description: Cursor pointing to the previous page in the list of results.  | validation: maxLength 16000


```

### Examples

### Query participants by progress status
Finds in-progress participants for a program.

```javascript
import { participants } from "@wix/online-programs";

async function queryParticipants() {
  const response = await participants
    .queryParticipants({ fields: ["PROGRESS"] })
    .eq("programId", "1a87c246-5c3a-4eea-a7c8-e5e2cf5d61c0")
    .eq("progressStatus", "IN_PROGRESS")
    .descending("_createdDate")
    .limit(50)
    .find();

  return response;
}

/* Promise resolves to:
 * {
 *   "items": [
 *     {
 *       "_id": "43db0e8d-4392-42d8-b3a6-56d412eb71e0",
 *       "programId": "1a87c246-5c3a-4eea-a7c8-e5e2cf5d61c0",
 *       "enrollmentStatus": "JOINED",
 *       "progressStatus": "IN_PROGRESS",
 *       "progress": {
 *         "totalStepsCompleted": 4,
 *         "totalStepsAvailable": 23,
 *         "completionPercentage": 17.4
 *       }
 *     }
 *   ],
 *   "length": 1,
 *   "pageSize": 50,
 *   "cursors": {}
 * }
 */
// The result also provides hasNext() and hasPrev() methods.

```

### queryParticipants (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 { participants } from '@wix/online-programs';
// Import the auth strategy for the relevant access type
// Import the relevant host module if needed

const myWixClient = createClient ({
  modules: { participants },
  // Include the auth strategy and host as relevant
});


async function queryParticipants(query,options) {
  const response = await myWixClient.participants.queryParticipants(query,options);
};
```

---