---
title: "Ad budget and every campaign, newest first"
method: GET
path: "/ads"
tags: ["Ads"]
---

# Ad budget and every campaign, newest first

`GET /ads`

## Request

- Base URL: `https://api.madethis.com/v1`
- URL: `https://api.madethis.com/v1/ads`
- Auth: HTTP bearer

## Query parameters

- `limit` integer

## Response `200`

Success envelope.

- object
  - `data` object, required
    - `budget` object, nullable, required
      - `status` 'active' | 'paused' | 'exhausted', required
      - `dailyBudgetCents` integer, required
      - `metaDailyBudgetCents` integer, required
      - `platformFeeBps` integer, required
      - `currentCycleSpendCents` integer, required
      - `weeklyCapCents` integer, required
      - `billingCycleStart` number, required
      - `billingCycleDays` integer, required
      - `prepaidCreditCents` integer, required
      - `availablePrepaidCents` integer, required
      - `fundingHoldReason` string, nullable, required
      - `prepaidRefundShortfallCents` integer, required
      - `settlementInFlight` boolean, required
      - `metaBudgetSyncStatus` 'pending' | 'synced' | 'failed', nullable, required
    - `campaigns` object[], required
      - `id` string, required
      - `status` string, required
      - `metaCampaignId` string, required
      - `destinationUrl` string, nullable, required
      - `reviewFeedback` string, nullable, required
      - `metrics` object, nullable, required
        - `spendCents` integer, required
        - `impressions` integer, required
        - `reach` integer, required
        - `clicks` integer, required
        - `cpc` number, required
        - `ctr` number, required
      - `lastSyncedAt` number, nullable, required
      - `activatedAt` number, nullable, required
      - `createdAt` number, required
      - `headline` string, nullable, required
      - `primaryText` string, nullable, required
      - `ctaType` string, nullable, required
      - `audienceDescription` string, nullable, required
    - `publishReadiness` object, required
      - `ready` boolean, required
      - `blockedReason` string, nullable, required
      - `goalPlanApproved` boolean, required
  - `hint` string: One-sentence orientation for agents.
  - `next_action` string: The literal next call an agent would chain.

## Other responses

- `default`: Error envelope — machine-readable `code` plus a docs link.

---

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