---
title: "High demand periods / budget schedules"
method: GET
path: "/v1/ads/high-demand-periods"
tags: ["Ad Accounts"]
---

# High demand periods / budget schedules

`GET /v1/ads/high-demand-periods`

Scheduled budget increases (Meta's budget-scheduling API). The Graph edge lives on the
campaign and ad-set nodes only, so exactly one of `campaignId` / `adSetId` (platform
ids) is required. Rows returned verbatim (budget_value, budget_value_type, time window,
recurrence).

## Query parameters

- `accountId` string, required
- `campaignId` string
- `adSetId` string
- `limit` integer
- `after` string

## Response `200`

Budget schedules (raw Meta shape)

- object
  - `objectId` string — The campaign / ad set id the schedules belong to.
  - `data` object[]
  - `paging` object
    - `after` string, nullable — Cursor for the next page; null when exhausted.

## Other responses

- `400` — Invalid input, or Meta rejected the query
- `401` — Unauthorized
- `501` — Only supported on Meta (facebook/instagram)

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/revisions/1e9a379eafca/schema)