Enquiries report

POST/v1/EnquiryReport/GetEnquiriesReport

Scope: enquiries.read

Retrieve a paginated list of enquiries.

Use this report to export enquiry data for analysis or downstream processing. Results can be filtered by status, booker details, company, affiliate group, and date ranges.

Request body

Parameters

pageNumberintegerOptional

Page number for pagination. Defaults to 1.

pageSizeintegerOptional

Page size for pagination. Defaults to 50.

statusinteger[]Optional

Filter to one or more enquiry status identifiers.

enquiryIdintegerOptional

Filter to a specific enquiry identifier.

bookerEmailstringOptional

Filter to enquiries where the booker email contains this value.

bookerCompanystringOptional

Filter to enquiries where the booker company contains this value.

bookerNamestringOptional

Filter to enquiries where the booker name contains this value.

companyIdintegerOptional

Filter to a specific company identifier.

affiliateGroupIdintegerOptional

Filter to a specific affiliate group identifier.

startDatedate-timeOptional

Filter enquiries with a start date on or after this value.

endDatedate-timeOptional

Filter enquiries with an end date on or before this value.

createdSincedate-timeOptional

Filter enquiries created on or after this value.

createdUntildate-timeOptional

Filter enquiries created on or before this value.

modifiedSincedate-timeOptional

Filter enquiries modified on or after this value.

modifiedUntildate-timeOptional

Filter enquiries modified on or before this value.

expand.enquiryVenuesbooleanOptional

Include venue details.

expand.enquiryDaybooleanOptional

Include enquiry day details.

expand.bedroomsbooleanOptional

Include bedroom details.

expand.customQuestionsbooleanOptional

Include custom question responses.

expand.customFieldsbooleanOptional

Include custom field values.

expand.approverbooleanOptional

Include approver details.

expand.addressExtrabooleanOptional

Include additional address details.

expand.taxesbooleanOptional

Include tax details. Defaults to true.

Response

Returns a paginated list of EnquirySummaryData objects.

The EnquirySummaryData object

enquiryIdinteger

Unique identifier for the enquiry.

enquiryNamestring

Display name of the enquiry.

meetingNamestring

Name of the meeting or event.

clientNamestring

Name of the client associated with the enquiry.

eventStartingDatedate-time

Start date and time of the event.

eventFinalDatedate-time

End date and time of the event.

enquiryStatusIdinteger

Current status identifier of the enquiry.

totalMeetingRoomsinteger

Total number of meeting rooms requested.

totalDaysinteger

Total number of event days.

totalAttendeesinteger

Total number of attendees across all days.

totalBedroomsinteger

Total number of bedrooms requested.

totalNightsinteger

Total number of bedroom nights.

activeEnquiryVersionIdinteger

Identifier of the active enquiry version, if any.

bookingTypeIdinteger

Identifier of the booking type.

locationEnteredstring

Location text entered for the enquiry.

affiliateGroupIdinteger

Identifier of the affiliate group, if applicable.

companyNamestring

Name of the company that owns the enquiry.

affiliateGroupNamestring

Name of the affiliate group, if applicable.

recordCreateddate-time

When the enquiry was created.

recordModifieddate-time

When the enquiry was last modified.

Expandable collections

The following collections are included only when the corresponding expand option is set to true. Click Show child attributes to reveal the fields inside each collection.

enquiryVenuesarray

Venues associated with the enquiry. Requires expand.enquiryVenues.

enquiryDaysarray

Day-by-day breakdown of the enquiry. Requires expand.enquiryDay.

enquiryAccommodationsarray

Bedroom requirements. Requires expand.bedrooms.

enquiryAccommodationExtrasarray

Extra accommodation items. Requires expand.bedrooms.

customQuestionsarray

Custom question responses. Requires expand.customQuestions.

customFieldsarray

Custom field values. Requires expand.customFields.

enquiryAttachmentsarray

Attachments associated with the enquiry. Included when attachments are expanded.

Pagination

pageNumberinteger

Current page number.

pageSizeinteger

Number of items per page.

totalCountinteger

Total number of matching entries.

Errors

Status	Meaning
`400 Bad Request`	Validation failed. Check the response for property-level errors.
`401 Unauthorized`	The Bearer token is missing, expired, or lacks the required scope.
`403 Forbidden`	The client is not permitted to view enquiry data.

Example request

curl -X POST https://dashboard.alpha.meetingsbooker.com/reportingapi/v1/EnquiryReport/GetEnquiriesReport \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "status": [1, 2],
    "companyId": 1001,
    "pageSize": 50
  }'

var response = await client.PostAsJsonAsync(
    "https://dashboard.alpha.meetingsbooker.com/reportingapi/v1/EnquiryReport/GetEnquiriesReport",
    new
    {
        status = new[] { 1, 2 },
        companyId = 1001,
        pageSize = 50
    });

var report = await response.Content.ReadFromJsonAsync<PaginatedList<EnquirySummaryDataDTO>>();

Example response

{
  "items": [
    {
      "enquiryId": 12345,
      "enquiryName": "Annual Conference 2025",
      "meetingName": "Board meeting",
      "clientName": "Example Ltd",
      "eventStartingDate": "2025-06-01T09:00:00Z",
      "eventFinalDate": "2025-06-03T17:00:00Z",
      "enquiryStatusId": 2,
      "totalMeetingRooms": 3,
      "totalDays": 3,
      "totalAttendees": 24,
      "totalBedrooms": 12,
      "totalNights": 36,
      "activeEnquiryVersionId": 67890,
      "bookingTypeId": 1,
      "locationEntered": "Dublin",
      "affiliateGroupId": 55,
      "companyName": "Example Ltd",
      "affiliateGroupName": "EMEA Group",
      "recordCreated": "2025-01-10T11:00:00Z",
      "recordModified": "2025-01-15T14:30:00Z",
      "enquiryVenues": [
        {
          "enquiryVenueId": 987,
          "venueId": 42,
          "venueName": "Grand Hotel Dublin",
          "venueAddress": "1 Merrion Square, Dublin 2",
          "mainImageUrl": "https://cdn.hubli.com/venues/42/main.jpg",
          "location": "Dublin",
          "enquiryVenueStatusId": 1,
          "isCompanyPreferred": true,
          "isAffiliatePreferred": false,
          "enquiryVenueProposalId": 1111
        }
      ],
      "enquiryDays": [
        {
          "enquiryDayId": 5001,
          "enquiryDate": "2025-06-01T00:00:00Z",
          "enquiryDayNumber": 1,
          "enquiryDayRooms": [
            {
              "enquiryDayRoomId": 7001,
              "roomName": "Wicklow Suite",
              "capacity": 30,
              "layoutId": 2,
              "startTime": "09:00",
              "endTime": "17:00"
            }
          ],
          "enquiryDayFoodDrinks": [
            {
              "enquiryDayFoodDrinkId": 8001,
              "foodDrinkTypeId": 3,
              "foodDrinkTypeName": "Working lunch",
              "quantity": 24,
              "servingTime": "12:30"
            }
          ]
        }
      ],
      "enquiryAccommodations": [
        {
          "enquiryAccommodationId": 9001,
          "accommodationTypeId": 1,
          "dateRequired": "2025-06-01T00:00:00Z",
          "numberRequired": 12
        }
      ],
      "enquiryAccommodationExtras": [
        {
          "enquiryAccommodationExtraId": 9501,
          "accommodationExtraTypeId": 2,
          "accommodationExtraTypeText": "Late checkout",
          "dateRequired": "2025-06-03T00:00:00Z",
          "quantity": 6,
          "notes": "For VIP attendees"
        }
      ],
      "customQuestions": [
        {
          "customFieldId": 101,
          "customFieldLabel": "Dietary requirements",
          "customData": [
            {
              "entityId": 202,
              "entityRecordId": 12345,
              "customResponseValue": "vegetarian",
              "customResponseText": "Vegetarian"
            }
          ]
        }
      ],
      "customFields": [
        {
          "customFieldId": 301,
          "fieldName": "cost_centre",
          "label": "Cost centre",
          "value": "CC-4412",
          "text": "CC-4412",
          "typeId": 1,
          "typeName": "Text"
        }
      ],
      "enquiryAttachments": [
        {
          "enquiryAttachmentId": 4001,
          "fileName": "agenda.pdf",
          "fileSize": 245760,
          "venueId": 42,
          "readOnly": false
        }
      ]
    }
  ],
  "pageNumber": 1,
  "pageSize": 50,
  "totalCount": 1
}