Skip to main content

CustomerData report mapping

If you're currently consuming the CustomerData CSV export from Auditdata's AuditdataCloud admin UI, this page shows how every column in that report maps to a field on the new API/Event surface (Sessions API + Service Bus events).

The new API exposes a strict superset of the report's useful columns, plus a handful of fields the report never carried — see the Data schema for the complete API payload. A small number of report columns are deliberately not exposed on the API; they're flagged below.

Conventions

  • API/Event field names are camelCase.
  • "—" in the API/Event column means the report column is not exposed on the new API; the row's Notes column says why.
  • Audiogram thresholds reference the new schema — see Audiograms.

Column-by-column mapping

The order below follows the report's natural column order so a CSV parser can be migrated row-for-row.

Report columnAPI/Event fieldNotes
StoreNameofficeNameOffice display name.
DevicedeviceTypeFree-form device type, e.g. "iPad".
ResultIdidListo's session id. Use as application idempotency key on the API.
TestDateTimetestTimeRFC 3339 UTC. The Sessions API filters on this field.
Titletitle
Firstnamefirstname
Lastnamelastname
BirthdaybirthdayRFC 3339 date-time at midnight UTC.
Emailemail
Phonephone
TestResultLeftleftTestResultCoded outcome — see Test result codes.
TestResultRightrightTestResultSee Test result codes.
LeftHL125Always null. Not exposed on the API.
LeftHL250leftAudiogram.f250dB threshold at 250 Hz.
LeftHL500leftAudiogram.f500
LeftHL750Always null. Not exposed on the API.
LeftHL1000leftAudiogram.f1000
LeftHL1500Always null. Not exposed on the API.
LeftHL2000leftAudiogram.f2000
LeftHL3000Always null. Not exposed on the API.
LeftHL4000leftAudiogram.f4000
LeftHL6000leftAudiogram.f6000
LeftHL8000leftAudiogram.f8000
RightHL125Always null. Not exposed on the API.
RightHL250rightAudiogram.f250
RightHL500rightAudiogram.f500
RightHL750Always null. Not exposed on the API.
RightHL1000rightAudiogram.f1000
RightHL1500Always null. Not exposed on the API.
RightHL2000rightAudiogram.f2000
RightHL3000Always null. Not exposed on the API.
RightHL4000rightAudiogram.f4000
RightHL6000rightAudiogram.f6000
RightHL8000rightAudiogram.f8000
BackgroundNoisenoiseLevelCoded ambient-noise level: "1" Silent, "2" Some noise, "3" A lot of noise. See Noise level codes. The report displays the raw string.
TransducertransducerName
StoreIdofficeIdListo internal office id (integer).
OfficeExternalIdofficeExternalIdTenant's primary external office id.
OfficeExternalAltIdofficeExternalAltIdTenant's alternate external office id.
DeviceNamedeviceName
EmailSentDateTimeemailSentDateTimenull on the Service Bus event — email sending is async and runs after the event is published, so it hasn't happened yet at emit time. The Sessions API returns the accurate value once the email has been dispatched.
EmailStatusemailStatusnull on the Service Bus event for the same reason. The Sessions API returns the accurate value once the email has been dispatched.
TestFlowNametestFlowName

Phantom audiogram frequencies

The report exposes 22 audiogram columns — 11 frequencies on each ear. Listo only measures and stores 7 frequencies per ear: 250, 500, 1000, 2000, 4000, 6000, 8000 Hz. The other four — 125, 750, 1500, 3000 Hz — are always null on the report. The API/Event drops these entirely rather than emitting permanently-null fields.

Fields new on the API/Event

The API/Event payload also carries a small number of fields that the CustomerData report never exposed:

  • stimulusType — coded stimulus presented to the patient (pure tone, warble, narrowband noise).
  • noiseCorrection — ambient-noise baseline applied to the raw measurements. Same 7-frequency shape as leftAudiogram / rightAudiogram.
  • Consent flagsconsentAgreeWithTermsConditions, consentContactEmail, consentContactPhone, consentCustom1/2/3. Nullable ints: 0 refused, 1 granted, null not asked.

See Data schema and Screening completed for the exact field shapes.