---
title: "List paid campaigns"
method: GET
path: "/v1/workspaces/{workspaceId}/ads/accounts/{accountId}/campaigns"
tags: ["Ads"]
---

# List paid campaigns

`GET /v1/workspaces/{workspaceId}/ads/accounts/{accountId}/campaigns`

## Request

- Base URL: `https://api.maevesocial.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.maevesocial.com/v1/workspaces/{workspaceId}/ads/accounts/{accountId}/campaigns`
- Auth: HTTP bearer

List the paid campaigns in one ad account, one page at a time. Each campaign carries its Maeve level, what the platform calls it, the platform ID, status, spend and delivery metrics, and the platform-specific fields under native. For LinkedIn the campaigns are campaign groups. Meta reports Lifetime unless startDate and endDate are given, and lists archived and deleted campaigns too (native.status.category), which the dashboard hides under All; native.allowedActions names what the dashboard offers on each. Read-only. For content campaigns use campaigns.list.

## Path parameters

- `accountId` string, required
- `workspaceId` string, uuid, required

## Response `200`

List paid campaigns

- object
  - `data` object, required
    - `account` object, required
      - `id` string, required
      - `platform` 'meta' | 'tiktok' | 'linkedin' | 'google' | 'pinterest', required
      - `providerAccountId` string, required: The account ID the platform uses.
      - `name` string, nullable, required
      - `currency` string, nullable, required
      - `timezone` string, nullable, required: IANA timezone the platform reports this account in.
      - `isEnabled` boolean, required
      - `credentialStatus` 'active' | 'revoked', required
    - `money` object, required
      - `unit` 'micros', required
      - `microsPerCurrencyUnit` 1000000, required
      - `currency` string, nullable, required: ISO currency of the ad account.
    - `freshness` object, required
      - `state` 'fresh' | 'partial' | 'stale' | 'empty' | 'stored', required: stored means Maeve served its last synced copy and did not ask the platform.
      - `refreshedAt` string, nullable, required: When the data was last refreshed from the platform.
    - `providerError` object, nullable, required: Set when the platform failed and stored data is shown.
      - `code` string, required: Maeve ads error code, for example ADS_PROVIDER_RATE_LIMITED.
      - `message` string, required
      - `retry` object, required
        - `retryable` boolean, required: Whether repeating the same request can succeed.
        - `action` 'retry_later' | 'reconnect_account' | 'grant_provider_permission' | 'enable_account' | 'correct_input' | 'refresh_and_check' | 'get_user_approval' | 'none', required: What to do before trying again.
        - `retryAfterSeconds` integer, nullable, required: Wait this long when the provider gave a time.
    - `entityLevels` object[], required
      - `level` 'campaign' | 'ad_set' | 'ad', required
      - `nativeType` string, required
    - `campaigns` object[], required
      - `level` 'campaign' | 'ad_set' | 'ad', required: Maeve level: campaign, ad_set or ad.
      - `nativeType` string, required: What the platform calls this level, for example campaign_group.
      - `nativeId` string, required: The platform ID for this entity.
      - `parentNativeId` string, nullable, required
      - `name` string, nullable, required
      - `status` string, nullable, required: Status as the platform reports it.
      - `metrics` object, required
        - `spendMicros` string, nullable, required
        - `impressions` string, nullable, required
        - `clicks` string, nullable, required
        - `results` string, nullable, required: Platform result count. LinkedIn has no results metric.
      - `unavailableMetrics` string[], required
      - `native` object, required: The platform-specific fields the dashboard shows for this entity.
    - `page` object, required
      - `limit` integer, required
      - `offset` integer, required
      - `total` integer, required
      - `hasMore` boolean, required
    - `native` object, required: Platform-specific list fields, such as the metrics window.
  - `meta` unknown, required

---

[API](https://skmtc.dev/maevesocial/apis/maeve-social-api.md) · [All operations](https://skmtc.dev/maevesocial/apis/maeve-social-api/llms.txt) · [OpenAPI document](https://skmtc.dev/maevesocial/apis/maeve-social-api/revisions/1b00fd7e4b15?raw)