List Meta ads

GET

/api/v1/meta/ads

Returns ads visible to the requested ad account and external-user context.

Request

Query Params

Header Params

Responses

🟢200OK

application/json

Meta ads list.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.adlyfy.dev/api/v1/meta/ads?adAccountId=undefined&adId=undefined&campaignId=undefined&adsetId=undefined&fields=undefined&after=undefined&limit=undefined&USD=undefined&convertMicros=undefined' \
--header 'x-api-key: MTc4ODk2MDQ0ODc1OF83MzZmM2RlMGRiODgzZmMxMWY3ZGRkMWMxNmE5NTQyMTU1NmM1ZDdkMmM3ZTRjNjk3OWQ3ZjAxYjFhMGZlMTEy' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXlsb2FkIjp7ImlkIjoiMjQxMWQxYzctMTFmMS00NDU4LWFiNWQtNWFiZTAxNmUzNDFkIiwidGVuYW50SWQiOiIzZDZkZmMyMC1kNDNlLTQ5ZDMtYTFjYy02YzkzZmRkY2M1NDUiLCJraW5kIjoiZXh0ZXJuYWxfdXNlciIsImV4dGVybmFsVXNlcklkIjoiZXh0ZXJuYWwtdXNlci0xMjMiLCJlbWFpbCI6bnVsbCwibmFtZSI6bnVsbH0sImlhdCI6MTc4ODk2MDY5NiwiZXhwIjoxNzg4OTgyMjk2fQ.c-AXOUKN8aVUZADMSYwZk8GgMRjIgT_CHlERP1i80UA'

Response Example

200 - Example 1

{
    "success": true,
    "message": "Request successful",
    "timestamp": "2026-03-30T12:00:00.000Z",
    "statusCode": 200,
    "data": {
        "data": [
            {
                "id": "120000000100",
                "name": "March - US - Ad 1",
                "status": "ACTIVE",
                "adset_id": "120000000010",
                "campaign_id": "120000000001",
                "creative": {
                    "id": "120000000200"
                },
                "created_time": "2026-03-01T10:05:00+0000"
            }
        ],
        "paging": {
            "cursors": {
                "before": "MAZDZD",
                "after": "MjQZD"
            }
        }
    }
}

Update Meta ad set status

Get Meta ad details