Skip to main content
GET
Retrieve ad campaigns for a specific Facebook ad account. This endpoint provides detailed information about campaigns, including budget, status, performance metrics, and scheduling details.
  • Campaign status may be one of: “ACTIVE”, “PAUSED”, “DELETED”, “ARCHIVED”, “IN_PROCESS”, or “WITH_ISSUES”
  • The metrics object contains performance data for the campaign
  • The budgetRemaining field represents the remaining budget in the account’s currency
  • Results are cached for 10 minutes to optimize performance

Header Parameters

Query Parameters

string
required
The ID of the ad account to retrieve campaigns for.The ad account id, with or without the act_ prefix (1234567890 or act_1234567890).
number
default:100
Limit the number of campaigns returned.