Metrics

Entity-scoped CAC detail for an analysis period

Customer acquisition cost for one concrete legal entity and an explicit analysis period (default: year to date). The numerator is explicit CAC-tagged sales & marketing spend (GL classification is reconciliation evidence, never a tag); the denominator is canonical new paying customers, available only with continuous subscription history from before the period start. When available is false, reason names why and no numeric zero is fabricated. The top-level available always equals metric.available: a snapshot can compute and still have no ratio (insufficient_inputs), in which case period and breakdown are still returned as evidence while metric.value is null.

get/companies/{companyId}/metrics/cac

Request

  • Base URL: https://api.medianfi.com/api/v1
  • URL: https://api.medianfi.com/api/v1/companies/{companyId}/metrics/cac
  • Auth: HTTP bearer

Query parameters

entityIdstring uuid

Concrete legal entity; defaults to the caller's single authorized entity.

period'ytd' | 'month'

Named analysis period (default ytd). Mutually exclusive with startDate/endDate.

startDatestring date
endDatestring date

Response

Availability-discriminated CAC detail payload

successboolean

Changes

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