Launch Campaigns Status

Check the status of a launch started via the Launch Campaigns endpoint.

Endpoint Details

URL: https://api.scalemate.co/api/external/v2/launch/:id

Method: GET

Headers

Content-Type: application/json
X-Api-Key: <YOUR_API_KEY>

You can generate the API Key at the Settings page under the API Key section.

Parameters

Parameter	Type	Description
id	string (required)	The job_id returned by the Launch Campaigns endpoint.

Example cURL Request

curl --location 'https://api.scalemate.co/api/external/v2/launch/63267564-2c14-4ccc-ab60-1a61a950a25d' \
--header 'X-Api-Key: <YOUR_API_KEY>'

Example Response

While the job is running:

{
  "job_id": "63267564-2c14-4ccc-ab60-1a61a950a25d",
  "status": "pending",
  "message": "Launch job has been accepted and is being processed",
  "type": "launcher_v2",
  "results": null
}

After it completes, results holds the same payload delivered to your webhook (without job_id):

{
  "job_id": "63267564-2c14-4ccc-ab60-1a61a950a25d",
  "status": "completed",
  "message": "Launch success",
  "type": "launcher_v2",
  "results": {
    "status": "success",
    "campaigns": [
      {
        "remote_id": "120210000000000000",
        "name": "US Prospecting",
        "adsets": [
          {
            "remote_id": "120210000000000001",
            "name": "Broad 25-45",
            "ads": [
              {
                "remote_id": "120210000000000002",
                "name": "promo_a",
                "source_url": "https://drive.google.com/file/d/1JbpRSvif7wR-6vwNA51A5pHcyHViSQ7d/view"
              }
            ]
          }
        ]
      }
    ],
    "error": null,
    "completed_at": "2026-07-16T10:05:00Z"
  }
}

• Top-level status — job lifecycle: pending, completed or failed.

• results.status — launch outcome: success, partial or failed. partial means some ads failed — inspect the campaigns tree (a failed ad has "remote_id": null and an "error").

• results is null until the job finishes.

See the Launch Campaigns endpoint for the full campaigns tree schema.