Ads Insights API Error Codes

Error code information for async sources will be available with Marketing API v25.0+.

Error CodeError SubcodeSourceSummaryDescription

-2

2490547

Async

Report Failed

Generating the report failed. Please try again later.

100

1504018

Sync

Request Timed Out

Your request timed out. Please try a smaller date range, fetch less data, or use async jobs.

4

1504022

Async & Sync

Too Many API Requests

Your app has exceeded the allowed number of API requests. Please wait before retrying. For more info, see API Rate Limits.

2

1504038

Sync

Request Timed Out

Your request timed out. Please try a smaller date range, fetch less data, or use async jobs.

4

1504039

Async & Sync

Too Many API Requests

Your app has exceeded the allowed number of API requests. Please wait before retrying. For more info, see API Rate Limits.

2

1504041

Async & Sync

Invalid Breakdowns

No data is available for the requested metrics and breakdowns. Please try different metrics or breakdowns. See Breakdowns Documentation.

2

1504042

Async & Sync

Invalid Custom Metrics

You are querying invalid custom metrics. Please try selecting different ones.

2

1504043

Async & Sync

Intermittent Error

Your request encountered an intermittent error, please retry at a later time.

2

1504044

Sync

Unknown Error Occurred

An unexpected error occurred. Please refresh the page or try again. If the issue persists, contact Meta Support.

-3

1504045

Async

Report Too Large

Your report was too large. Check the documentation for guidance and try again. See Data Per Call Limits.

100

3191001

Async & Sync

Permission Error

Ads Insights API permission denied.