List launches
Launch Batches for an ad account, newest first, including launches made from the Adnova dashboard. Each row is the same shape Get launch returns. This is how to recover a lost batchId: if a Create a launch call timed out after the batch was committed, list recent launches here rather than re-submitting (or retry with the same Idempotency-Key). Filter by status and by adName (case-insensitive substring match against any ad in the batch). status=processing also matches pending, so it answers "still running". Paginate with skip / limit.
Authentication
authentication Create an API key from the Adnova dashboard (Account integrations). Pass the key value in the api-key request header on every call.
In: header
Path Parameters
Adnova internal ad-account id from List ad accounts.
1 <= lengthQuery Parameters
Only batches in this status. processing also matches pending.
"pending" | "processing" | "partially_completed" | "completed" | "failed"Only batches containing an ad whose name contains this text (case-insensitive).
Number of batches to skip. Defaults to 0.
00 <= valuePage size. Defaults to and is capped at 250.
2501 <= value <= 250Header Parameters
Workspace the request operates in. Get it from List workspaces.
1 <= lengthOrganization context (required on every endpoint). For lookup endpoints the org is derived from the ad account in the URL, so any org id you have access to is accepted.
1 <= lengthResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.adnova.ai/ad-launcher/v1/meta/ad-accounts/string/launches" \ -H "x-workspace-id: string" \ -H "x-org-id: string"{
"data": [
{
"_id": "01H8YB...",
"platform": "meta",
"adAccountId": "01H8Y4...",
"accountId": "1234567890",
"status": "pending",
"ads": [
{
"id": "01HQK7M8N3VC8D4R6Z2E5J7B9P",
"adName": "string",
"adSets": [
"string"
],
"launchedAdDetails": [
{
"adId": "120208....",
"adsetId": "120208....",
"status": "completed",
"effectiveStatus": "string",
"error": "string",
"fbError": [
{}
]
}
]
}
],
"createdAt": "2019-08-24T14:15:22Z",
"createdBy": "string",
"modifiedAt": "2019-08-24T14:15:22Z",
"modifiedBy": "string"
}
],
"total": 42
}{
"error": {
"code": "string",
"message": "string"
},
"message": "string"
}{
"error": {
"code": "string",
"message": "string"
},
"message": "string"
}{
"error": {
"code": "string",
"message": "string"
},
"message": "string"
}{
"error": {
"code": "string",
"message": "string"
},
"message": "string"
}{
"error": {
"code": "string",
"message": "string"
},
"message": "string"
}