---
updatedAt: 2026-04-24T17:51:50.000Z
agentTools:
  projectIndex: https://developers.koddi.com/llms.txt
---

# Media Plan

Returns a single media plan including nested campaign_configs and ad_group_configs per experience

<br />

## Response

<HTMLBlock>{`
<table>
<thead>
<tr>
<th>Field</th><th>Type</th><th>Description</th>
</tr>
</thead>
<tbody>

<tr>
<td class="tg-viy4">media_plans</td><td class="tg-viy4">array of objects</td><td class="tg-viy4">The media plans</td>
</tr>
<tr>
<td class="tg-viy4">&nbsp;&nbsp;&nbsp;&nbsp;always_on</td><td class="tg-viy4">boolean</td><td class="tg-viy4">Whether always on</td>
</tr>
<tr>
<td class="tg-viy4">&nbsp;&nbsp;&nbsp;&nbsp;budget_type</td><td class="tg-viy4">string</td><td class="tg-viy4">The budget type. Values: Daily, Weekly, Monthly, Custom, One-time, Uncapped</td>
</tr>
<tr>
<td class="tg-viy4">&nbsp;&nbsp;&nbsp;&nbsp;ecpm_goal</td><td class="tg-viy4">number</td><td class="tg-viy4">The ecpm goal</td>
</tr>
<tr>
<td class="tg-viy4">&nbsp;&nbsp;&nbsp;&nbsp;end_date</td><td class="tg-viy4">string</td><td class="tg-viy4">The end date (YYYY-MM-DD)</td>
</tr>
<tr>
<td class="tg-viy4">&nbsp;&nbsp;&nbsp;&nbsp;experience_configurations</td><td class="tg-viy4">array of objects</td><td class="tg-viy4">The experience configurations</td>
</tr>
<tr>
<td class="tg-viy4">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;base_bid_amount</td><td class="tg-viy4">number</td><td class="tg-viy4">The base bid amount</td>
</tr>
<tr>
<td class="tg-viy4">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;bid_prediction_enabled</td><td class="tg-viy4">boolean</td><td class="tg-viy4">Whether bid prediction enabled</td>
</tr>
<tr>
<td class="tg-viy4">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;budget_allocation</td><td class="tg-viy4">number</td><td class="tg-viy4">The budget allocation</td>
</tr>
<tr>
<td class="tg-viy4">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;experience_id</td><td class="tg-viy4">integer</td><td class="tg-viy4">The experience id</td>
</tr>
<tr>
<td class="tg-viy4">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;experience_name</td><td class="tg-viy4">string</td><td class="tg-viy4">The experience name</td>
</tr>
<tr>
<td class="tg-viy4">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;is_auto_bid</td><td class="tg-viy4">boolean</td><td class="tg-viy4">Whether this is an auto bid</td>
</tr>
<tr>
<td class="tg-viy4">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;is_primary</td><td class="tg-viy4">boolean</td><td class="tg-viy4">Whether this is a primary</td>
</tr>
<tr>
<td class="tg-viy4">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;submitted</td><td class="tg-viy4">boolean</td><td class="tg-viy4">Whether submitted</td>
</tr>
<tr>
<td class="tg-viy4">&nbsp;&nbsp;&nbsp;&nbsp;goal</td><td class="tg-viy4">number</td><td class="tg-viy4">The goal</td>
</tr>
<tr>
<td class="tg-viy4">&nbsp;&nbsp;&nbsp;&nbsp;goal_type</td><td class="tg-viy4">string</td><td class="tg-viy4">The goal type. Values: GRE, ROAS, Spend, Volume, tCPA</td>
</tr>
<tr>
<td class="tg-viy4">&nbsp;&nbsp;&nbsp;&nbsp;insertion_order_id</td><td class="tg-viy4">integer</td><td class="tg-viy4">The insertion order id</td>
</tr>
<tr>
<td class="tg-viy4">&nbsp;&nbsp;&nbsp;&nbsp;is_fixed_budget</td><td class="tg-viy4">boolean</td><td class="tg-viy4">Whether this is a fixed budget</td>
</tr>
<tr>
<td class="tg-viy4">&nbsp;&nbsp;&nbsp;&nbsp;media_plan_id</td><td class="tg-viy4">integer</td><td class="tg-viy4">The media plan id</td>
</tr>
<tr>
<td class="tg-viy4">&nbsp;&nbsp;&nbsp;&nbsp;name</td><td class="tg-viy4">string</td><td class="tg-viy4">The media plans name</td>
</tr>
<tr>
<td class="tg-viy4">&nbsp;&nbsp;&nbsp;&nbsp;objective</td><td class="tg-viy4">string</td><td class="tg-viy4">The campaign objective. Values: conversion, awareness</td>
</tr>
<tr>
<td class="tg-viy4">&nbsp;&nbsp;&nbsp;&nbsp;start_date</td><td class="tg-viy4">string</td><td class="tg-viy4">The start date (YYYY-MM-DD)</td>
</tr>
<tr>
<td class="tg-viy4">&nbsp;&nbsp;&nbsp;&nbsp;status</td><td class="tg-viy4">string</td><td class="tg-viy4">The media plans status. Values: Active, Pending, Paused</td>
</tr>
<tr>
<td class="tg-viy4">&nbsp;&nbsp;&nbsp;&nbsp;total_budget</td><td class="tg-viy4">number</td><td class="tg-viy4">The total budget</td>
</tr>
</tbody>
</table>
`}</HTMLBlock>

## Try it!

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "v2-campaign-management",
    "version": "1"
  },
  "servers": [
    {
      "url": "https://koddi.io/console/v2/"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "header",
        "name": "Authorization",
        "x-bearer-format": "bearer"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/member_groups/{memberGroupId}/advertisers/{advertiserId}/media_plan/{mediaPlanId}": {
      "get": {
        "summary": "Media Plan",
        "description": "Returns a single media plan including nested campaign_configs and ad_group_configs per experience",
        "operationId": "internal-reporting-1-1",
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"targeting_dimensions\": [\n    {\n      \"id\": 23,\n      \"name\": \"User History\",\n      \"parameter_name\": \"user_history\",\n      \"targeting_options_count\": 2,\n      \"ad_group_usage_count\": 432,\n      \"deleted\": false\n    }\n  ]\n}\n"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false,
        "parameters": [
          {
            "in": "path",
            "name": "memberGroupId",
            "schema": {
              "type": "string"
            },
            "required": true
          },
          {
            "in": "path",
            "name": "advertiserId",
            "schema": {
              "type": "string"
            },
            "required": true
          },
          {
            "in": "path",
            "name": "mediaPlanId",
            "schema": {
              "type": "string"
            },
            "required": true
          }
        ]
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```