Documentation menu

Get ad account

One ad account with its status, spend, and spending limit.

GEThttps://app.tryadeli.com/api/v1/ads/accounts/{adAccountId}

AuthorizationBearer <API key>How keys work

Request

curl --fail-with-body "https://app.tryadeli.com/api/v1/ads/accounts/act_1234567890?accountId=00000000-0000-0000-0000-000000000000" \
  -H "Authorization: Bearer $ADELI_API_KEY"

Response

{
  "platform": "facebook",
  "accountId": "00000000-0000-0000-0000-000000000000",
  "profileId": "00000000-0000-4000-8000-000000000002",
  "adAccount": {
    "id": "act_1234567890",
    "accountId": "1234567890",
    "name": "Client A — Ads",
    "currency": "USD",
    "timezoneName": "America/New_York",
    "accountStatus": 1,
    "minDailyBudget": 100,
    "businessId": "1122334455",
    "businessName": "Client A"
  },
  "details": {
    "id": "act_1234567890",
    "currency": "USD",
    "accountStatus": 1,
    "disableReason": 0,
    "spendCap": 500,
    "amountSpent": 182.4,
    "hasPaymentMethod": true
  }
}

The account as listed, plus details: accountStatus, disableReason, amountSpent and spendCap in whole currency units (spendCap is null when there is none), and hasPaymentMethod — null when Meta withholds it, which it does unless the person has the MANAGE task on the account. Always read live.

Path parameters

adAccountIdstringRequired: An ad account id, in Meta's act_<digits> form.