Get launch

Request

GET /launches/{id} on https://api.apogee.ad/api/v1.

Path parameters

• id string path required

  Launch id

  1 to 64 characters

  Matches ^[\w-]+$

Headers

• Authorization string header required

  Bearer apk_…: an API key with the scope of this route.

Response

200.

• finished boolean
• status string

  One of not launched, starting, processing, completed, failed, interrupted

• id string or null
• plan_id string or null
• files object
  Fields (3)

  • total number or null
  • completed number or null
  • failed number or null
• result object or null
  Fields (5)

  • success boolean
  • summary object
  • adsets array of objects
    Fields of each item (2)

    • id string or null
    • name string or null
  • ads_ok array of strings
  • errors any
• interrupted_at string or null
• note string or null
• error string or null

Every answer carries X-Request-Id (give it to support), Apogee-Version: 2026-10-06, and the RateLimit and RateLimit-Policy headers.

Errors

Errors are application/problem+json with a stable code to switch on (all the codes).

Example

With your key in APOGEE_API_KEY (create one):

curl 'https://api.apogee.ad/api/v1/launches/120200000000000001' \
  -H "Authorization: Bearer $APOGEE_API_KEY"

{
  "id": "120200000000000001",
  "plan_id": "7b0f3c52-4d1e-4c8a-9f61-2a5e8d3c1b90",
  "finished": false,
  "status": "not launched",
  "files": {
    "total": 3,
    "completed": 3,
    "failed": 0
  },
  "result": {
    "success": false,
    "summary": {},
    "adsets": [
      {
        "id": "120200000000000001",
        "name": "Nordlicht | Spring launch"
      }
    ],
    "ads_ok": [
      "120200000000000001"
    ],
    "errors": "120200000000000001"
  },
  "interrupted_at": "2026-10-23T09:00:00.000Z",
  "note": "Example text",
  "error": "120200000000000001"
}

Access and cost

Related operations

• Get launch questions: POST /ad-accounts/{acc}/launch-questions
• Create launch plan: POST /launch-plans
• Get launch plan: GET /launch-plans/{id}
• Confirm launch plan: POST /launch-plans/{id}/confirm
• Get launch plan status: GET /launch-plans/{id}/status
• List launches: GET /launches