Enquiry audit report

POST/v1/EnquiryReport/{enquiryId}/Audit

Scope: enquiries.read

Retrieve the audit trail for a single enquiry.

This is a convenience endpoint that wraps the audit report and pre-filters it to the Enquiries entity type and the supplied enquiry identifier.

Request body

Parameters

enquiryIdintegerRequired

Path parameter: identifier of the enquiry to audit.

sincedate-timeRequired

Inclusive start of the reporting period in ISO 8601 format.

untildate-timeOptional

Inclusive end of the reporting period in ISO 8601 format.

pageNumberintegerOptional

Page number for pagination. Defaults to 1.

pageSizeintegerOptional

Page size for pagination. Defaults to 100.

expand.payloadbooleanOptional

Include the raw payload for each audit entry.

expand.aggregatesbooleanOptional

Include aggregate data for each audit entry.

Response

Returns a paginated list of AuditReporting objects for the specified enquiry.

The AuditReporting object

auditRecordIdstring

Unique identifier of the audit record.

entityIdstring

Identifier of the Enquiries entity type.

entityRecordIdstring

Identifier of the enquiry record that was audited.

entityTypestring

Name of the entity type.

operationTypestring

Type of operation, for example Create, Update, or Delete.

recordCreateddate-time

When the audit record was created.

dateAuditeddate-time

Date and time of the audited action.

userIdinteger

Identifier of the user who performed the action.

companyIdinteger

Identifier of the company associated with the action.

originalValuesstring

Serialized original values, when available.

newValuesstring

Serialized new values, when available.

correlationIdstring

Correlation identifier for tracing the action.

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 or the request body is missing.
`401 Unauthorized`	The Bearer token is missing, expired, or lacks the required scope.
`403 Forbidden`	The client is not permitted to view this enquiry or audit data.

Example request

curl -X POST https://dashboard.alpha.meetingsbooker.com/reportingapi/v1/EnquiryReport/12345/Audit \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "since": "2025-01-01T00:00:00Z",
    "until": "2025-01-31T23:59:59Z"
  }'

var response = await client.PostAsJsonAsync(
    "https://dashboard.alpha.meetingsbooker.com/reportingapi/v1/EnquiryReport/12345/Audit",
    new
    {
        since = DateTimeOffset.Parse("2025-01-01T00:00:00Z"),
        until = DateTimeOffset.Parse("2025-01-31T23:59:59Z")
    });

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

Example response

{
  "items": [
    {
      "auditRecordId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "entityId": "5",
      "entityRecordId": "12345",
      "entityType": "Enquiry",
      "operationType": "Update",
      "recordCreated": "2025-01-15T09:23:00Z",
      "dateAudited": "2025-01-15T09:23:00Z",
      "userId": 42,
      "companyId": 1001,
      "originalValues": "{\"status\":1}",
      "newValues": "{\"status\":2}",
      "correlationId": "corr-9876543210"
    }
  ],
  "pageNumber": 1,
  "pageSize": 100,
  "totalCount": 1
}