---
title: "List New Strategy Groups"
method: GET
path: "/new_strategy_groups"
tags: ["New Strategy Groups"]
---

# List New Strategy Groups

`GET /new_strategy_groups`

## Request

- Base URL: `https://api.mediamath.com/api/v3.0`
- URL: `https://api.mediamath.com/api/v3.0/new_strategy_groups`
- Auth: OAuth 2
  - Authorization code: `https://auth.mediamath.com/authorize`
  - Token URL: `https://auth.mediamath.com/oauth/token` scopes: `offline_access`, `manage:services`
- TypeScript: <https://skmtc.dev/mediamath/apis/campaigns-api/docs/new_strategy_groups/get.ts> (a function with typed inputs; its response is checked against the schema)

Get a paginated list of strategy groups. The `q` parameter must include a
`campaign_id==<id>` clause (required for permission scoping); additional filter
clauses (joined by `&`, URL-encoded as `%26`) and `sort_by` follow the standard
Campaigns API list-endpoint convention and may reference any `strategy_groups`
column — e.g. `q=campaign_id==100%26name=:Prospecting*&sort_by=-spend_cap_amount`.

## Query parameters

- `page_limit` integer
- `page_offset` integer
- `sort_by` string
- `q` string
- `full` string
- `with` string

## Response `200`

List new strategy groups response

- union
  - NewStrategyGroupCollection
    - `data` NewStrategyGroupListItem[]
      - `id` integer
      - `entity_type` string
      - `name` string
      - `campaign_id` integer
      - `strategy_count` integer: Number of strategies attached to this group. Always present.
      - `strategies` NewStrategyGroupStrategyEmbed[]: Attached strategies. Only present when ?with=strategies is set.
        - `id` integer
        - `entity_type` string
        - `name` string
        - `status` boolean: true when the strategy is active.
        - `pacing_type` 'even' | 'asap'
        - `pacing_amount` number, float
        - `pacing_interval` 'hour' | 'day'
        - `impression_pacing_type` 'even' | 'asap' | 'no-limit'
        - `impression_pacing_amount` integer, nullable
        - `impression_pacing_interval` 'hour' | 'day'
    - `meta` ListMetadata
      - `status` string, required: The status of the response, indicating success or failure.
      - `count` integer, required: The number of items returned in the current response.
      - `total_count` integer: The total number of items available in the dataset.
      - `offset` integer: The offset from the start of the dataset, used for pagination.
      - `next_page` string: The URL to fetch the next page of results.
      - `prev_page` string: The URL to fetch the previous page of results.
  - NewStrategyGroupCollectionFull
    - `data` NewStrategyGroupFull[]
      - `name` string
      - `description` string, nullable
      - `spend_cap_type` 'even' | 'asap' | 'no-limit'
      - `spend_cap_amount` number, float, nullable: Required when spend_cap_type is 'even' or 'asap' and spend_cap_automatic is false. Optional (and may be null) when spend_cap_type is 'no-limit'. May be sent while spend_cap_automatic is true but is ignored until automatic is turned off.
      - `impression_cap_type` 'even' | 'asap' | 'no-limit'
      - `impression_cap_amount` integer, nullable: Required when impression_cap_type is 'even' or 'asap' and impression_cap_automatic is false. Optional (and may be null) when impression_cap_type is 'no-limit'. May be sent while impression_cap_automatic is true but is ignored until automatic is turned off.
      - `external_identifier` string, nullable
      - `id` integer
      - `entity_type` string
      - `version` integer
      - `campaign_id` integer
      - `strategy_count` integer: Number of strategies attached to this group. Always present.
      - `strategies` NewStrategyGroupStrategyEmbed[]: Attached strategies. Only present when ?with=strategies is set.
        - `id` integer
        - `entity_type` string
        - `name` string
        - `status` boolean: true when the strategy is active.
        - `pacing_type` 'even' | 'asap'
        - `pacing_amount` number, float
        - `pacing_interval` 'hour' | 'day'
        - `impression_pacing_type` 'even' | 'asap' | 'no-limit'
        - `impression_pacing_amount` integer, nullable
        - `impression_pacing_interval` 'hour' | 'day'
      - `created_on` string, date-time
      - `updated_on` string, date-time
    - `meta` ListMetadata
      - `status` string, required: The status of the response, indicating success or failure.
      - `count` integer, required: The number of items returned in the current response.
      - `total_count` integer: The total number of items available in the dataset.
      - `offset` integer: The offset from the start of the dataset, used for pagination.
      - `next_page` string: The URL to fetch the next page of results.
      - `prev_page` string: The URL to fetch the previous page of results.

## Other responses

- `400`: Error response
- `401`: Error response
- `403`: Error response
- `404`: Error response

---

[API](https://skmtc.dev/mediamath/apis/campaigns-api.md) - [All operations](https://skmtc.dev/mediamath/apis/campaigns-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mediamath/apis/campaigns-api/revisions/408743891def?raw)