# Device Technology 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 %}

## Versions

The API allows you to determine the version of the Device Technology Report by presenting a query parameter of  or .

Starting October 3rd, 2017  reports will include:

- Device Brand – eg: Apple, Amazon, and Google
- Device Model – eg: iPhone, Kindle Fire, Pixel
- Browser Version – eg: Google Chrome
- OS Version – eg: Windows 10

This insight will allow you to plan and assess performance based on device and browser, now inclusive of Mobile devices.  Please note this release does not include targeting for these fields.

Initially, the  reports will only contain 31 days of data starting from September 2nd, 2017. New data will be added to the reports moving forward, accumulating to the full 90 days of data; the max number of days a user is currently able to pull technology report data for.

* All existing saved/scheduled technology reports in Data Export will continue to pull data from the old reporting framework until November 1st, 2017. However, these reports will no longer be editable, meaning you may only export or deactivate the reports in the interim.
* Additionally, all currently saved/scheduled technology reports will be 
* From November 1st, 2017 technology reports will pull data from the  version of the reports by default.
* The export will also contain 31 days of data starting from September 2nd, 2017 and accumulate to the full 90 days.

Endpoint: GET /device_technology/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.