---
title: "Get Meta Page ads volume (running ads, limit, remaining)"
method: GET
path: "/api/v1/ad_accounts/{id}/ads_volume"
tags: ["Ad Accounts"]
---

# Get Meta Page ads volume (running ads, limit, remaining)

`GET /api/v1/ad_accounts/{id}/ads_volume`

## Request

- Base URL: `https://getscaleforge.com`
- URL: `https://getscaleforge.com/api/v1/ad_accounts/{id}/ads_volume`
- Auth: HTTP bearer

Meta enforces a per-Page ads limit (default **250** running/in-review).
This endpoint returns the cached counters from `MetaPage` for the
account's associated Page so callers can pre-check capacity before
uploading a new batch of creatives.

## Response `200`

Success

- object
  - `data` object
    - `account_id` integer
    - `page_id` string, nullable
    - `page_name` string, nullable
    - `active_ads_count` integer
    - `ads_limit` integer
    - `remaining` integer

## Other responses

- `404`: Account not found

---

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