Get Meta Ad Account Details
meta_ads_get_ad_account_detailsRetrieve detailed information about a Meta ad account, including status, balance, currency, and spend. Use the ad account ID to fetch the details.
Instructions
Get detailed information about a specific Meta ad account.
Args:
act_id (string): The ad account ID prefixed with 'act_', e.g., 'act_1234567890'
fields (string[]): Optional. Fields to retrieve. If omitted, defaults to: name, business_name, age, account_status, balance, amount_spent, attribution_spec, account_id, business, business_city, brand_safety_content_filter_levels, currency, created_time, id.
Returns: Object with the requested ad account fields. Key fields:
id (string): Ad account ID
name (string): Account display name
account_status (number): Status code (1=ACTIVE, 2=DISABLED, 3=UNSETTLED, etc.)
currency (string): Account currency code (e.g., 'USD')
balance (string): Current account balance
amount_spent (string): Total lifetime spend
Examples:
Use when: "Get details for ad account act_123456"
Use when: "What is the currency and balance of my ad account?"
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| act_id | Yes | Ad account ID prefixed with 'act_', e.g., 'act_1234567890' | |
| fields | No | List of specific fields to retrieve. If omitted, default fields are returned |