# Report Meta

{% admonition type="danger" name="This API is deprecated and will be removed in July 2026" %}
  The new API docs can be found here: https://apidocs.mediamath.com/apis/reporting-api
{% /admonition %}

The examples used in this section are truncated versions of . 
The use of "..." in an example is meant to indicate truncation of other properties.  The Definition section of this endpoint provides information 
about how the metadata may vary from report to report.  The Definition section of the  
provides a reference to the query string parameters that it accepts.


Endpoint: GET /{report}/meta

## Path parameters:

  - `report` (string, required)
    This must be a report discoverable from https://apidocs.mediamath.com/apis/reporting-api-v1/metadata/get_meta.

## Header parameters:

  - `Cookie` (string, required)
    _

## Response 200 fields (*/*):

  - `Name` (string, required)
    This is the human-readable name of the report.  It is not recognized by any API input.

  - `Version` (integer, required)
    This is the version of the report.  See the  section for more details.

  - `Description` (string)

  - `URI_Data` (string, required)
    This is the URI for the report's  endpoint.

  - `URI_Meta` (string, required)
    This is the URI for the report's .

  - `Transition` (object)
    Reports may change over time.  This object will be present if the report will undergo a breaking change.  See the  section for more details.

  - `Transition.replaced_by` (string, required)
    The URL where the metadata for the next version of the report may be found.

  - `Transition.transition_date` (string, required)
    After this GMT time the current version of the report will no longer be available.

  - `Transition.next_version` (integer, required)
    The version replacing the current version of the report.

  - `Deprecation` (object)
    Reports may be deprecated all together, or superseded by another report.  This object will be present if the report is scheduled for deprecation.   See the  section for more details.

  - `Deprecation.superseded_by` (string)
    Optionally provides the metadata URI for the superseding report.

  - `Deprecation.deprecation_date` (string, required)
    The GMT time when the report will no longer be available.  When a report is past its  it will no longer appear in the .  All endpoints having to do specifically with that report will return a 410 GONE response.

  - `Type` (string)

  - `currency` (string)
    Provides information about the currency of the  fields typed as "money".

When set to "campaign currency", the currency varies from record to record.  To determine the currency for a particular record, the campaign_currency_code  field should be requested, if available for the report.

Any other value should be taken to be the currency for all records of the report.

  - `data_retention` (string)
    Indicates how far back data is available.  This can be a date, datetime, or time window as specified by the "time_window" and "Special Time Windows" sections of .  This property should be used very loosely.  It may not be accurate.  It is meant to give a general idea.

  - `default_metrics` (array, required)
    This is the list of metrics that will be returned if the  parameter is not specified in a call to the .

  - `structure` (object, required)

  - `structure.time_field` (object, required)
    Mapping of field names seen in

  - `structure.dimensions` (object, required)
    Mapping of field names seen in

  - `structure.metrics` (object, required)
    Mapping of field names seen in

  - `time_aggregation` (string)
    This property indicates the finest granularity of the .  For reports with a  of the  type, this will be "by_hour", "by_day", etc.  When the type is , this will be "various".

  - `time_rollups` (array, required)
    This property indicates the available levels of granularity for the .  It lists the valid values of the  parameter used for the  endpoint.  For reports with a  of the  type, this tends to be a combination of "by_hour", "by_day", "by_week", "by_month", "all", etc.  When the type is , this will only include "all".

  - `time_windows` (array, required)
    Lists the acceptable formats for the  parameter used by the .  Some values may be used as is, others may need to be modified.  For details see the time_window section of  .

  - `timezone` (string)
    Provides information about the timezone of the  for the report.

When set to "campaign timezone", the timezone varies from record to record.  To determine the currency for a particular record, the campaign_timezone  field should be requested, if available for the report.

Any other value should be taken to be the timezone for all records of the report.