Hubli APIv1

MERF report

POST/v1/MerfReport/GetMerfReport
Scope: merf.read

Retrieve a list of MERF submissions.

Use this report to export MERF (event form) submissions for analysis or downstream processing. Results can be filtered by modification or creation date, company, affiliate, form, and event.

Aggregate record modified

Each report row includes an aggregateRecordModified timestamp in addition to the existing recordModified timestamp.

  • recordModified changes only when the submission itself is edited.
  • aggregateRecordModified changes when the submission or any of its child records — such as field responses, attachments, or submitter person details — are added, updated, or soft-deleted. For example, adding a new field response updates the submission's aggregateRecordModified, but not necessarily its recordModified.

When you filter by modifiedSince and modifiedUntil, the API returns rows where either recordModified or aggregateRecordModified falls within the range. This ensures downstream consumers do not miss changes that occurred only on child records.

Request body

Parameters

pageNumberintegerOptional
Page number for pagination. Defaults to 1.
pageSizeintegerOptional
Page size for pagination. Defaults to 100.
modifiedSincedate-timeOptional
Filter submissions modified on or after this date. Matches when either the submission's own `recordModified` or its aggregate `aggregateRecordModified` timestamp falls within the range.
modifiedUntildate-timeOptional
Filter submissions modified on or before this date. Matches when either the submission's own `recordModified` or its aggregate `aggregateRecordModified` timestamp falls within the range.
createdSincedate-timeOptional
Filter submissions created on or after this date.
createdUntildate-timeOptional
Filter submissions created on or before this date.
companyIdintegerOptional
Filter to a specific company identifier.
affiliateIdintegerOptional
Filter to a specific affiliate identifier.
formIdintegerOptional
Filter to a specific form identifier.
eventIdintegerOptional
Filter to a specific event identifier.
expand.personbooleanOptional
Include submitter person details.
expand.fieldResponsesbooleanOptional
Include form field responses.
expand.attachmentsbooleanOptional
Include attachment details.

Response

Returns a paginated list of MerfReport objects.

The MerfReport object

submissionIdinteger

Unique submission identifier.

formIdinteger

Identifier of the submitted form.

formNamestring

Name of the form.

formTypeNamestring

Type name of the form.

eventIdinteger

Identifier of the linked event, if any.

userIdinteger

Identifier of the user who submitted the form.

userNamestring

Name of the submitting user.

userEmailstring

Email address of the submitting user.

statusstring

Current status of the submission.

submittedDatedate-time

Date the submission was submitted.

recordCreateddate-time

When the submission record was created.

recordModifieddate-time

When the submission record was last modified.

aggregateRecordModifieddate-time

When the submission or any of its child records were last modified.

Expandable collections

personobject

Submitter person details. Requires expand.person.

fieldResponsesarray

Form field responses. Requires expand.fieldResponses.

attachmentsarray

Submission attachments. Requires expand.attachments.

Pagination

pageNumberinteger

Current page number.

pageSizeinteger

Number of items per page.

totalCountinteger

Total number of matching entries.

Errors

StatusMeaning
400 Bad RequestValidation failed. Check the response for property-level errors.
401 UnauthorizedThe Bearer token is missing, expired, or lacks the required scope.
403 ForbiddenThe client is not permitted to view MERF submissions.
Example request
curl -X POST https://dashboard.alpha.meetingsbooker.com/reportingapi/v1/MerfReport/GetMerfReport \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "formId": 10,
    "eventId": 555,
    "pageSize": 50
  }'