AdnovaDocs
Ad Launcher

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.

GET
/meta/ad-accounts/{adAccountId}/launches

Authentication

authentication
api-key<token>

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

adAccountId*string

Adnova internal ad-account id from List ad accounts.

Length1 <= length

Query Parameters

status?string

Only batches in this status. processing also matches pending.

Value in"pending" | "processing" | "partially_completed" | "completed" | "failed"
adName?string

Only batches containing an ad whose name contains this text (case-insensitive).

skip?integer

Number of batches to skip. Defaults to 0.

Default0
Range0 <= value
limit?integer

Page size. Defaults to and is capped at 250.

Default250
Range1 <= value <= 250

Header Parameters

x-workspace-id*string

Workspace the request operates in. Get it from List workspaces.

Length1 <= length
x-org-id*string

Organization 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.

Length1 <= length

Response 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"
}