---
title: "List Meta Ad Accounts owned by the authenticated user"
method: GET
path: "/api/v1/ad_accounts"
tags: ["Ad Accounts"]
---

# List Meta Ad Accounts owned by the authenticated user

`GET /api/v1/ad_accounts`

## Request

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

Returns only visible accounts, ordered by `position` then `name`. Requires scope `accounts:read`.

## Response `200`

Success

- object
  - `data` object[]
    - `id` integer
    - `name` string
    - `meta_account_id` string
    - `business_id` string, nullable
    - `page_id` string, nullable
    - `page_name` string, nullable
    - `pixel_id` string, nullable
    - `pixel_name` string, nullable
    - `connected` boolean
    - `position` integer, nullable
    - `rate_limit_usage` number, nullable
    - `last_used_at` string, date-time, nullable

## Other responses

- `401`: Unauthorized
- `403`: Missing accounts:read scope

---

[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)