Get Campaign

Retrieve details for one campaign in the workspace associated with your Developer API key.

GET
/v1/campaigns/:campaign

Retrieve a campaign by UUID

Path parameters

campaignstring Required

Campaign UUID

Request
cURL
curl "https://api.leadpush.io/v1/campaigns/:campaign" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {token}"
Response Example
{
  "data": {
    "uuid": "<campaign_uuid>",
    "name": "Welcome series",
    "description": "Onboard new subscribers",
    "status": "running",
    "tags": ["<tag_uuid>"],
    "active_version_uuid": "<active_version_uuid>",
    "display_version_number": 3,
    "has_unpublished_changes": true,
    "created_at": "2026-09-01T14:30:00.000000Z",
    "updated_at": "2026-10-01T09:15:00.000000Z",
    "draft_version_uuid": "<draft_version_uuid>",
    "active_execution_count": 42
  }
}

Success and Errors

Expected outcomes for campaign lookups

  • Successful requests return a campaign from the API key's workspace.
  • The endpoint returns 404 when the UUID does not exist in that workspace.
  • A campaign UUID from another workspace is not accessible and also returns 404.