List bridged ads

What it does

Request

GET /bridged-ads on https://api.apogee.ad/api/v1.

Query parameters

• limit integer query optional

  Page size

  Default 50

  1 to 200

• cursor string query optional

  next_cursor of the previous page

• source_platform string query optional

  Default meta

  One of meta, tiktok, snapchat

• source_ad_account_id string query required

  The ad account (list_ad_accounts): Meta act_…, a TikTok advertiser id, a Snapchat ad account id

  Matches ^(act_\d{1,32}|[A-Za-z0-9][A-Za-z0-9-]{0,63})$

Headers

• Authorization string header required

  Bearer apk_…: an API key with the scope of this route.

Response

200. A page of results: pass next_cursor as cursor for the next one, limit from 1 to 200 (default 50).

• data array of objects
  Fields of each item (5)

  • source_ad_id string
  • name string or null
  • last_at string or null
  • count number or null
  • targets array of objects
    Fields of each item (6)

    • platform string

      One of meta, tiktok, snapchat

    • ad_account_id string or null
    • ad_id string or null
    • adset_id string or null
    • smart_plus boolean
    • at string or null
• has_more boolean
• next_cursor string or null

Every answer carries X-Request-Id (give it to support), Apogee-Version: 2026-10-06, and the RateLimit and RateLimit-Policy headers.

Errors

Errors are application/problem+json with a stable code to switch on (all the codes).

Example

With your key in APOGEE_API_KEY (create one):

curl 'https://api.apogee.ad/api/v1/bridged-ads?source_ad_account_id=act_1234567890' \
  -H "Authorization: Bearer $APOGEE_API_KEY"

{
  "data": [
    {
      "source_ad_id": "120200000000000003",
      "name": "Nordlicht | Spring launch",
      "last_at": "2026-10-23T09:00:00.000Z",
      "count": 3,
      "targets": [
        {
          "platform": "meta",
          "ad_account_id": "act_1234567890",
          "ad_id": "120200000000000003",
          "adset_id": "120200000000000002",
          "smart_plus": false,
          "at": "2026-10-23T09:00:00.000Z"
        }
      ]
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Access and cost

In the MCP

An AI assistant does the same with this tool of the MCP server:

• list_bridge_transfers: The ads already bridged from a source ad account, newest first, with where each one went.

Related operations

• Create bridge transfer: POST /bridge-transfers
• Confirm bridge transfer: POST /bridge-transfers/{id}/confirm
• Get bridge transfer: GET /bridge-transfers/{id}
• Get bridge stats: GET /bridged-ads/stats
• Get bridge daily stats: GET /bridged-ads/daily-stats