> For the complete documentation index, see [llms.txt](https://scalemate.gitbook.io/scalemate-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://scalemate.gitbook.io/scalemate-api/api/launch-campaigns-status.md).

# Launch Campaigns Status

Check the status of a launch started via the [Launch Campaigns](https://www.scalemate.co/docs/api/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](https://app.scalemate.co/profile) page under the API Key section.

### Parameters

| Parameter | Type              | Description                                                                                                   |
| --------- | ----------------- | ------------------------------------------------------------------------------------------------------------- |
| `id`      | string (required) | The `job_id` returned by the [Launch Campaigns](https://www.scalemate.co/docs/api/launch-campaigns) endpoint. |

### Example cURL Request

```bash
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:

```json
{
  "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`):

```json
{
  "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](https://www.scalemate.co/docs/api/launch-campaigns) endpoint for the full `campaigns` tree schema.