# Get a New Strategy Plan

Get a new strategy plan by ID

Endpoint: GET /new_strategy_plans/{strategy_plan_id}
Version: 3.0.1807
Security: Auth0

## Path parameters:

  - `strategy_plan_id` (integer, required)
    Numeric ID of the strategy_plan object to get

## Query parameters:

  - `extended` (boolean)
    Get extended properties in response

## Response 200 fields (application/json):

  - `body` (new_strategy_plan_response (object) or new_strategy_plan_response_extended (object)) — one of:
    - new_strategy_plan_response:
      - `data` (object)
        New Strategy Plan
      - `data.campaign_start_date` (string)
      - `data.campaign_end_date` (string)
      - `data.campaign_zone_name` (string)
      - `data.name` (string)
      - `data.feature_compatibility` (string)
      - `data.device_graph_only` (boolean)
      - `data.zone_name` (string)
        Example: "America/New_York"
      - `data.campaign_service_type` (string)
      - `data.type` (string)
      - `data.duration` (object)
      - `data.duration.use_campaign_start` (boolean)
      - `data.duration.use_campaign_end` (boolean)
      - `data.duration.start_date` (string,null)
      - `data.duration.end_date` (string,null)
      - `data.budget` (object)
      - `data.budget.budget` (number,null)
        Must be a valid float between 1 and 10000000 USD or its equivalent in other currency.
      - `data.budget.currency_code` (string)
      - `data.goals` (object)
      - `data.goals.goal_type` (string)
        Enum: "spend", "reach", "cpc", "cpe", "cpa", "roi", "ctr", "vcr", "viewability_rate", "vcpm", ""
      - `data.goals.goal_value` (number)
      - `data.goals.min_bid` (number)
      - `data.goals.max_bid` (number)
      - `data.goals.roi_target` (number,null)
      - `data.goals.bid_min_devices` (integer,null)
        Example: 1
      - `data.goals.bid_aggressiveness` (integer)
      - `data.goals.bid_price_is_media_only` (boolean)
      - `data.goals.max_bid_wm` (number,null)
      - `data.goals.use_bid_shading` (boolean)
      - `data.frequency` (object)
      - `data.frequency.frequency_type` (string,null)
        Enum: "even", "asap", "no-limit", "t1-optimized"
      - `data.frequency.frequency_interval` (string)
        Enum: "hour", "day", "week", "month", "campaign", "not-applicable"
      - `data.frequency.frequency_amount` (integer)
        Example: 5
      - `data.frequency.frequency_optimization` (boolean)
      - `data.inventory` (object)
      - `data.inventory.run_on_all_pmp` (boolean, required)
      - `data.inventory.run_on_all_exchanges` (boolean, required)
      - `data.inventory.site_restriction_transparent_urls` (boolean)
      - `data.inventory.domain_restrictions` (object)
      - `data.inventory.domain_restrictions.include` (array)
      - `data.inventory.domain_restrictions.include.domain` (string, required)
        Example: "www.mediamath.com"
      - `data.inventory.domain_restrictions.include.target_type` (string, required)
        Enum: "DOMAIN", "APP"
      - `data.inventory.domain_restrictions.exclude` (array)
      - `data.inventory.site_lists` (array)
      - `data.inventory.site_lists.site_list_id` (integer, required)
        Example: 32
      - `data.inventory.site_lists.assigned` (boolean, required)
      - `data.inventory.deals` (array)
      - `data.inventory.deals.deal_id` (integer, required)
        Example: 8
      - `data.inventory.deal_groups` (array)
      - `data.inventory.deal_groups.deal_group_id` (integer, required)
        Example: 9
      - `data.inventory.supply_sources` (array)
      - `data.inventory.supply_sources.supply_source_id` (integer, required)
        Example: 54
      - `data.targeting` (object)
      - `data.targeting.fold_position` (array,null)
        Enum: "ABOVE", "BELOW", "UNCATEGORIZED"
      - `data.targeting.audience` (object)
      - `data.targeting.audience.include` (array)
      - `data.targeting.audience.include.operator` (string)
        Enum: "AND", "OR"
      - `data.targeting.audience.include.segments` (array)
      - `data.targeting.audience.include.segments.audience_segment_id` (integer, required)
        Example: 24
      - `data.targeting.audience.include.segments.user_cpm` (number,null)
        user_cpm is stored in the currency of the campaign and will not fluctuate with daily exchange rates.
      - `data.targeting.audience.exclude` (object)
      - `data.targeting.audience.exclude.operator` (string)
        Enum: same as `data.targeting.audience.include.operator` in "new_strategy_plan_response" (2 values)
      - `data.targeting.audience.exclude.segments` (array)
      - `data.targeting.contextual` (object)
      - `data.targeting.contextual.include` (array)
      - `data.targeting.contextual.include.code` (string)
      - `data.targeting.contextual.include.operator` (string)
        Enum: same as `data.targeting.audience.include.operator` in "new_strategy_plan_response" (2 values)
      - `data.targeting.contextual.include.segments` (array)
      - `data.targeting.contextual.include.segments.targeting_segment_id` (integer, required)
        Example: 33
      - `data.targeting.contextual.include.segments.user_cpm` (number,null)
        user_cpm is stored in the currency of the campaign and will not fluctuate with daily exchange rates.
      - `data.targeting.contextual.exclude` (object)
      - `data.targeting.contextual.exclude.code` (string)
      - `data.targeting.contextual.exclude.operator` (string)
        Enum: same as `data.targeting.audience.include.operator` in "new_strategy_plan_response" (2 values)
      - `data.targeting.contextual.exclude.segments` (array, required)
      - `data.targeting.postal_codes` (object)
      - `data.targeting.postal_codes.restriction` (string)
        Example: "INCLUDE"
      - `data.targeting.geofence` (object)
      - `data.targeting.geofence.include` (object)
      - `data.targeting.geofence.include.operator` (string)
        Enum: same as `data.targeting.audience.include.operator` in "new_strategy_plan_response" (2 values)
      - `data.targeting.geofence.include.segments` (array)
      - `data.targeting.geofence.include.segments.geofence_segment_id` (integer)
        Example: 45
      - `data.targeting.geofence.include.segments.geofence_segment_factual_id` (string)
      - `data.targeting.geofence.exclude` (object)
      - `data.targeting.my_data` (object)
      - `data.targeting.my_data.include` (object)
      - `data.targeting.my_data.include.operator` (string)
        Enum: same as `data.targeting.audience.include.operator` in "new_strategy_plan_response" (2 values)
      - `data.targeting.my_data.include.pixels` (array, required)
      - `data.targeting.my_data.include.pixels.pixel_id` (integer, required)
        Example: 65
      - `data.targeting.my_data.exclude` (object)
      - `data.targeting.location` (object)
      - `data.targeting.location.include` (array)
      - `data.targeting.location.include.operator` (string)
        Enum: same as `data.targeting.audience.include.operator` in "new_strategy_plan_response" (2 values)
      - `data.targeting.location.include.target_value_id` (integer, required)
        Example: 87
      - `data.targeting.location.include.code` (string, required)
        Enum: "DMAX", "REGN", "CITY", "COUNTRY"
      - `data.targeting.location.exclude` (array)
      - `data.targeting.technology` (object)
      - `data.targeting.technology.include` (array)
      - `data.targeting.technology.include.operator` (string)
        Enum: same as `data.targeting.audience.include.operator` in "new_strategy_plan_response" (2 values)
      - `data.targeting.technology.include.code` (string, required)
        Enum: "BSER", "CSPD", "DVCE", "ISPX", "OSXX", "INVT", "VPSZ", "VLIN", "VCON", "VAUD", "VSKP", "VPLC", "DVMD", "BRLG", "IPTA", "HYPL"
      - `data.targeting.technology.include.target_value_id` (integer, required)
        Example: 77
      - `data.targeting.technology.exclude` (array)
      - `data.targeting.ip_addresses` (object)
      - `data.targeting.ip_addresses.restriction` (string)
        Enum: "INCLUDE", "EXCLUDE", ""
      - `data.targeting.day_parts` (array)
      - `data.targeting.day_parts.user_time` (boolean)
      - `data.targeting.day_parts.start_hour` (integer, required)
        Example: 1
      - `data.targeting.day_parts.end_hour` (integer, required)
        Example: 5
      - `data.targeting.day_parts.days` (array, required)
        Enum: "M", "T", "W", "R", "F", "S", "U"
      - `data.targeting.recency` (array)
      - `data.targeting.recency.pixel_id` (integer, required)
        Example: 67
      - `data.targeting.recency.from_hour` (integer, required)
        Example: 5
      - `data.targeting.recency.to_hour` (integer, required)
        Example: 7
      - `data.targeting.language_codes` (array)
      - `data.targeting.language_codes.code` (string)
      - `data.targeting.language_codes.name` (string)
      - `data.creatives` (object)
      - `data.creatives.ad_expandable` (boolean,null, required)
      - `data.creatives.ad_formats` (array,null, required)
      - `data.creatives.ad_sizes` (array,null, required)
      - `data.id` (integer)
        Example: 33
      - `data.version` (integer)
        Example: 3
      - `data.campaign_id` (integer)
        Example: 8
      - `meta` (object)
      - `meta.status` (string)
        Example: "success"
    - new_strategy_plan_response_extended:
      - `data` (object)
        New Strategy Plan (extended)
      - `data.campaign_start_date` (string)
      - `data.campaign_end_date` (string)
      - `data.campaign_zone_name` (string)
      - `data.name` (string)
      - `data.feature_compatibility` (string)
      - `data.device_graph_only` (boolean)
      - `data.zone_name` (string)
        Example: "America/New_York"
      - `data.campaign_service_type` (string)
      - `data.type` (string)
      - `data.duration` (object)
      - `data.duration.use_campaign_start` (boolean)
      - `data.duration.use_campaign_end` (boolean)
      - `data.duration.start_date` (string,null)
      - `data.duration.end_date` (string,null)
      - `data.budget` (object)
      - `data.budget.budget` (number,null)
        Must be a valid float between 1 and 10000000 USD or its equivalent in other currency.
      - `data.budget.currency_code` (string)
      - `data.goals` (object)
      - `data.goals.goal_type` (string)
        Enum: same as `data.goals.goal_type` in "new_strategy_plan_response" (11 values)
      - `data.goals.goal_value` (number)
      - `data.goals.min_bid` (number)
      - `data.goals.max_bid` (number)
      - `data.goals.roi_target` (number,null)
      - `data.goals.bid_min_devices` (integer,null)
        Example: 1
      - `data.goals.bid_aggressiveness` (integer)
      - `data.goals.bid_price_is_media_only` (boolean)
      - `data.goals.max_bid_wm` (number,null)
      - `data.goals.use_bid_shading` (boolean)
      - `data.frequency` (object)
      - `data.frequency.frequency_type` (string,null)
        Enum: same as `data.frequency.frequency_type` in "new_strategy_plan_response" (4 values)
      - `data.frequency.frequency_interval` (string)
        Enum: same as `data.frequency.frequency_interval` in "new_strategy_plan_response" (6 values)
      - `data.frequency.frequency_amount` (integer)
        Example: 5
      - `data.frequency.frequency_optimization` (boolean)
      - `data.inventory` (object)
      - `data.inventory.run_on_all_pmp` (boolean, required)
      - `data.inventory.run_on_all_exchanges` (boolean, required)
      - `data.inventory.site_restriction_transparent_urls` (boolean)
      - `data.inventory.domain_restrictions` (object)
      - `data.inventory.domain_restrictions.include` (array)
      - `data.inventory.domain_restrictions.include.domain` (string, required)
        Example: "www.mediamath.com"
      - `data.inventory.domain_restrictions.include.target_type` (string, required)
        Enum: same as `data.inventory.domain_restrictions.include.target_type` in "new_strategy_plan_response" (2 values)
      - `data.inventory.domain_restrictions.exclude` (array)
      - `data.inventory.site_lists` (array)
      - `data.inventory.site_lists.site_list_id` (integer, required)
        Example: 32
      - `data.inventory.site_lists.assigned` (boolean, required)
      - `data.inventory.deals` (array)
      - `data.inventory.deals.deal_id` (integer, required)
        Example: 8
      - `data.inventory.deal_groups` (array)
      - `data.inventory.deal_groups.deal_group_id` (integer, required)
        Example: 9
      - `data.inventory.supply_sources` (array)
      - `data.inventory.supply_sources.supply_source_id` (integer, required)
        Example: 54
      - `data.targeting` (object)
      - `data.targeting.fold_position` (array,null)
        Enum: same as `data.targeting.fold_position` in "new_strategy_plan_response" (3 values)
      - `data.targeting.audience` (object)
      - `data.targeting.audience.include` (array)
      - `data.targeting.audience.include.operator` (string)
        Enum: same as `data.targeting.audience.include.operator` in "new_strategy_plan_response" (2 values)
      - `data.targeting.audience.include.segments` (array)
      - `data.targeting.audience.include.segments.audience_segment_id` (integer, required)
      - `data.targeting.audience.include.segments.audience_segment_name` (string)
        available only when extended
      - `data.targeting.audience.include.segments.cpm` (number)
        available only when extended
      - `data.targeting.audience.include.segments.user_cpm` (number)
        available only when extended
      - `data.targeting.audience.include.segments.currency_code` (string)
        available only when extended
      - `data.targeting.audience.include.segments.full_path` (string)
        available only when extended
      - `data.targeting.audience.include.segments.size` (integer)
        available only when extended
      - `data.targeting.audience.include.segments.vendor_id` (integer)
        available only when extended
      - `data.targeting.audience.include.segments.vendor_name` (string)
        available only when extended
      - `data.targeting.audience.include.segments.code` (string)
        available only when extended
      - `data.targeting.audience.exclude` (object)
      - `data.targeting.audience.exclude.operator` (string)
        Enum: same as `data.targeting.audience.include.operator` in "new_strategy_plan_response" (2 values)
      - `data.targeting.audience.exclude.segments` (array)
      - `data.targeting.contextual` (object)
      - `data.targeting.contextual.include` (array)
      - `data.targeting.contextual.include.code` (string)
      - `data.targeting.contextual.include.operator` (string)
        Enum: same as `data.targeting.audience.include.operator` in "new_strategy_plan_response" (2 values)
      - `data.targeting.contextual.include.segments` (array)
      - `data.targeting.contextual.include.segments.targeting_segment_id` (integer, required)
      - `data.targeting.contextual.include.segments.targeting_segment_name` (string)
        available only when extended
      - `data.targeting.contextual.include.segments.full_path` (string)
        available only when extended
      - `data.targeting.contextual.include.segments.vendor_id` (integer)
        available only when extended
      - `data.targeting.contextual.include.segments.vendor_name` (string)
        available only when extended
      - `data.targeting.contextual.include.segments.objective_type_id` (integer)
        available only when extended
      - `data.targeting.contextual.include.segments.objective_type_name` (string)
        available only when extended
      - `data.targeting.contextual.include.segments.retail_cpm` (number)
        available only when extended
      - `data.targeting.contextual.include.segments.user_cpm` (number)
        available only when extended
      - `data.targeting.contextual.include.segments.currency_code` (string)
        available only when extended
      - `data.targeting.contextual.include.segments.external_code` (string)
        available only when extended
      - `data.targeting.contextual.exclude` (object)
      - `data.targeting.contextual.exclude.code` (string)
      - `data.targeting.contextual.exclude.operator` (string)
        Enum: same as `data.targeting.audience.include.operator` in "new_strategy_plan_response" (2 values)
      - `data.targeting.contextual.exclude.segments` (array, required)
      - `data.targeting.postal_codes` (object)
      - `data.targeting.postal_codes.restriction` (string)
        Example: "INCLUDE"
      - `data.targeting.postal_codes.count` (integer)
        Example: 5
      - `data.targeting.geofence` (object)
      - `data.targeting.geofence.include` (object)
      - `data.targeting.geofence.include.operator` (string)
        Enum: same as `data.targeting.audience.include.operator` in "new_strategy_plan_response" (2 values)
      - `data.targeting.geofence.include.segments` (array)
      - `data.targeting.geofence.include.segments.geofence_segment_id` (integer, required)
      - `data.targeting.geofence.include.segments.geofence_segment_factual_id` (string, required)
      - `data.targeting.geofence.include.segments.name` (string)
        available only when extended
      - `data.targeting.geofence.include.segments.status` (boolean)
        available only when extended
      - `data.targeting.geofence.include.segments.updated_on` (string)
        available only when extended
      - `data.targeting.geofence.exclude` (object)
      - `data.targeting.my_data` (object)
      - `data.targeting.my_data.include` (object)
      - `data.targeting.my_data.include.operator` (string)
        Enum: same as `data.targeting.audience.include.operator` in "new_strategy_plan_response" (2 values)
      - `data.targeting.my_data.include.pixels` (array, required)
      - `data.targeting.my_data.include.pixels.pixel_id` (integer, required)
      - `data.targeting.my_data.include.pixels.pixel_name` (string)
        available only when extended
      - `data.targeting.my_data.include.pixels.pixel_type` (string)
        available only when extended
        Enum: "event", "data", "dynamic"
      - `data.targeting.my_data.include.pixels.owner_type` (string)
        available only when extended
        Enum: "advertiser", "agency"
      - `data.targeting.my_data.include.pixels.owner_id` (integer)
        available only when extended
      - `data.targeting.my_data.include.pixels.owner_name` (string)
        available only when extended
      - `data.targeting.my_data.exclude` (object)
      - `data.targeting.location` (object)
      - `data.targeting.location.include` (array)
      - `data.targeting.location.include.target_value_id` (integer, required)
      - `data.targeting.location.include.name` (string)
        available only when extended
      - `data.targeting.location.include.full_path` (string)
        available only when extended
        Example: "United States >> New York >> New York"
      - `data.targeting.location.include.code` (string)
        Enum: same as `data.targeting.location.include.code` in "new_strategy_plan_response" (4 values)
      - `data.targeting.location.include.provider_code` (string)
        provider/source code from the underlying target value (e.g. "US", "DMA-501"); available only when extended
      - `data.targeting.location.include.target_value` (integer)
        available only when extended
      - `data.targeting.location.exclude` (array)
      - `data.targeting.technology` (object)
      - `data.targeting.technology.include` (array)
      - `data.targeting.technology.include.code` (string, required)
        Enum: same as `data.targeting.technology.include.code` in "new_strategy_plan_response" (16 values)
      - `data.targeting.technology.include.target_value_id` (integer, required)
      - `data.targeting.technology.include.name` (string)
        available only when extended
      - `data.targeting.technology.include.target_value` (integer)
        available only when extended
      - `data.targeting.technology.exclude` (array)
      - `data.targeting.ip_addresses` (object)
      - `data.targeting.ip_addresses.restriction` (string)
        Enum: same as `data.targeting.ip_addresses.restriction` in "new_strategy_plan_response" (3 values)
      - `data.targeting.ip_addresses.count` (integer)
        Example: 500
      - `data.targeting.day_parts` (array)
      - `data.targeting.day_parts.user_time` (boolean)
      - `data.targeting.day_parts.start_hour` (integer, required)
        Example: 1
      - `data.targeting.day_parts.end_hour` (integer, required)
        Example: 5
      - `data.targeting.day_parts.days` (array, required)
        Enum: same as `data.targeting.day_parts.days` in "new_strategy_plan_response" (7 values)
      - `data.targeting.recency` (array)
      - `data.targeting.recency.pixel_id` (integer, required)
        Example: 67
      - `data.targeting.recency.from_hour` (integer, required)
        Example: 5
      - `data.targeting.recency.to_hour` (integer, required)
        Example: 7
      - `data.targeting.language_codes` (array)
      - `data.targeting.language_codes.code` (string)
      - `data.targeting.language_codes.name` (string)
      - `data.creatives` (object)
      - `data.creatives.ad_expandable` (boolean,null, required)
      - `data.creatives.ad_formats` (array,null, required)
      - `data.creatives.ad_sizes` (array,null, required)
      - `data.id` (integer)
        Example: 33
      - `data.version` (integer)
        Example: 3
      - `data.campaign_id` (integer)
        Example: 8
      - `meta` (object)
      - `meta.status` (string)
        Example: "success"

## Response 400 fields (application/json):

  - `errors` (array, required)

  - `errors.code` (string)

  - `errors.field` (string)
    Optional when it is a schema error

  - `errors.message` (string)

  - `meta` (object, required)

  - `meta.status` (string, required)