> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getmeasure.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Metrics Data

> Retrieve a specific metrics data



## OpenAPI

````yaml https://api.getmeasure.com/api/v1/docs/api_spec.json post /companies/{company_id}/report/cached_metrics
openapi: 3.1.0
info:
  title: Measure API
  description: APIs to communicate with Measure
  version: 1.0.0
servers:
  - url: https://api.getmeasure.com/api/v1
security: []
paths:
  /companies/{company_id}/report/cached_metrics:
    post:
      tags:
        - Metrics
      summary: Get Metrics Data
      description: Retrieve a specific metrics data
      operationId: Get_Metrics_Data
      parameters:
        - name: company_id
          in: path
          description: 'The company ID with the prefix ''cmp_''. '
          required: true
          schema:
            description: 'The company ID with the prefix ''cmp_''. '
            type: string
        - name: Idempotency-Key
          in: header
          description: >-
            The idempotency key that will be used to ensure the request is only
            performed once
          schema:
            description: >-
              The idempotency key that will be used to ensure the request is
              only performed once
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RequestCachedMetricChartRequest'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/ResponseMetricsChartResponse'
                type: array
      deprecated: false
      security:
        - apiKey:
            - ''
components:
  schemas:
    RequestCachedMetricChartRequest:
      properties:
        frequency:
          enum:
            - DAY
            - WEEK
            - MONTH
            - QUARTER
          type: string
        grouping:
          default: NONE
          enum:
            - NONE
            - PRODUCT
            - PRICING
            - PRODUCT_TAGS
            - PRICING_TAGS
          type: string
        metric:
          description: The metric chart type
          enum:
            - ACTIVE_SUBS
            - NEW_SUBS
            - CHURNED_SUBS
            - ACTIVE_TRIALS
            - NEW_TRIALS
            - CHURNED_TRIALS
            - CONVERTED_TRIALS
            - ACTIVE_CUSTOMERS
            - NEW_CUSTOMERS
            - CHURNED_CUSTOMERS
            - NET_REVENUE
            - TOTAL_REVENUE
            - TOTAL_INVOICED_REVENUE
            - MRR
            - ARR
            - MRR_GROWTH
            - FEES
            - UPGRADES
            - DOWNGRADES
            - USER_CHURN
            - REVENUE_CHURN
            - NET_REVENUE_CHURN
            - ARPU
            - LTV
            - ARPL
            - OTHER_REVENUE
            - LICENSES
            - HISTORICAL_ARPU
            - APPLICATION_FEES_CONNECTED_ACCOUNTS
            - REVENUE_CONNECTED_ACCOUNTS
            - DISCOUNTS_REDEEMED
            - FAILED_CHARGES
            - REFUNDS
            - NEW_REFUNDS
            - REACTIVATIONS
          type: string
        period:
          $ref: '#/components/schemas/ModelPeriod'
      required:
        - metric
        - period
        - frequency
      type: object
    ResponseMetricsChartResponse:
      properties:
        metrics:
          items:
            $ref: '#/components/schemas/ResponseMetricsChartData'
          type: array
      type: object
    ModelPeriod:
      description: The period with a start and end date range
      properties:
        end_date:
          description: The end date of the period in RFC-3339 format
          format: date-time
          type: string
        start_date:
          description: The start date of the period in RFC-3339 format
          format: date-time
          type: string
      type: object
    ResponseMetricsChartData:
      properties:
        grouping:
          additionalProperties:
            $ref: '#/components/schemas/ModelMetricGroupingResponse'
          description: The metrics grouped by the grouping parameter if sent in the request
          type:
            - object
            - 'null'
        period:
          $ref: '#/components/schemas/ModelPeriod'
          description: The period for the metrics response with start and end date
        value:
          description: The aggregate metric value for the period
      type: object
    ModelMetricGroupingResponse:
      properties:
        key:
          type: string
        name:
          type: string
        value: {}
      type: object
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer

````