Event Level Analytics

Registrants

Retrieves a list of registrants for a particular event.

  • If double opt-in verification was enabled at the time of registration for an event and a user has not completed the verification process, the user will not be included in any endpoint responses.
  • dateFilterMode parameter options (not case-sensitive):
    • If the parameter is not included or no value is supplied, startDate and endDate will work in the manner they usually do.
    • "lastActivity" is the only supported value. When passed, the response will include only those registrants who have had activity between (and including) the provided startDate and endDate. Registrant lastActivity value is updated with a new modified date whenever one of the following API endpoints gets invoked to modify the registration information:
      • REST Registration
      • Update Registrant (client-level)
      • Forget Registrant (client-level)
      • Forget All Registrant (client-level)
      • Forget All Registrant (event-level)
get/client/{clientId}/event/{eventId}/registrant

Request

  • Base URL: https://api.on24.com/wcc/api/v2
  • URL: https://api.on24.com/wcc/api/v2/client/{clientId}/event/{eventId}/registrant
  • Auth: one of:
    • API key in header AccessTokenKey
    • API key in header AccessTokenSecret

Path parameters

clientIdnumber required

The client id

eventIdnumber required

The event id

Query parameters

dateIntervalinteger

Number of days returned in a response. See Rolling Interval.

dateIntervalOffsetinteger

Number of days from which the interval should encompass. See Rolling Interval.

dateIntervalTimezonestring

Timezone to be used for determining the 24 hour period that constitutes a day. See Rolling Interval.

startdatestring

Limit results to registrants with registration date after startDate

enddatestring

Limit results to registrants with registration date before endDate

partnerrefstring

Filter by partnerref

userstatusstring

Filter to users based on their status. If not provided, only regular users will be returned. Possible values: any: will return all registrants, including: active, soft-deleted and forgotten registrants. deleted: will return soft-deleted users only. forgotten: will return forgotten users only. all: deprecated - will include regular and soft-deleted users. Note: By design, there is No option to exclude soft-deleted users from the response.

emailstring

email registrant filter

noshowstring

Filters registrants who did not show up for the event

filterforgottenstring

Deprecated - Forgotten registrants filter. Y: only forgotten users will be returned in the response. N: forgotten users will be omitted in the response.

excludeanonymousstring

Deprecated - System-Generated (anonymous) email addresses are now always excluded from responses. This parameter is retained for backward compatibility but no longer affects the result set.

datefiltermodestring

Type of date to be used with the startDate and endDate parameters.

Headers

accessTokenKeystring required

Security Parameter

accessTokenSecretstring required

Security Parameter

acceptstring

Output format. possible values: Application/xml or Application/json

Response

Return list of registrants for an event

  • This endpoint returns data on people who registered for a Virtual Environment (VE).
  • Properties that will not be returned for VE registrants include:
    • userprofileurl
    • engagementprediction
    • emailformat
  • The following values are cached on the server between 3 - 24 hours:
    • engagementprediction

Changes

No recorded changes to this operation across all 1 revision of this API.