LEleadfeeder
Campaigns
v1

Get Campaign Details

Changed on

Fetch detailed information about a specific campaign using its campaign ID. Use the include parameter to attach related campaign data, campaign settings, list, or custom feed information to the result.

:::info Requires the campaigns:read OAuth2 scope. :::

get/v1/campaigns/{id}

Request

  • Base URL
    https://api.leadfeeder.com
  • URL
    https://api.leadfeeder.com/v1/campaigns/{id}
  • Auth
    • API key in header X-Api-Key
    • or OAuth 2
      Authorization code: https://api.leadfeeder.com/v1/oauth/authorize
      Token URL: https://api.leadfeeder.com/v1/oauth/token scopes: campaigns:read

Path parameters

idstring required

The campaign ID.

Query parameters

account_idstring required

The Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.

includestring

Comma-separated list of related resources to inline inside each campaign's relationships block. Unknown values are silently ignored.

Supported values:

  • campaign_summary — aggregated lifetime campaign performance metrics (impressions, clicks, costs, reach, …).

  • campaign_settings — campaign-level configuration toggles such as brand safety domain exclusion and auto-include behaviour.

  • campaign_locations — geographical targets attached to the campaign.

  • list — the audience list (target companies) backing the campaign.

  • custom_feed — the custom website-visit feed used to retarget visitors.

By default (no include), each relationship in the response carries only an id / type reference (or null when not configured).

Response

Success

Example response

{
  "data": {
    "attributes": {
      "budget": 1000,
      "budget_left": 1000,
      "budget_type": "total",
      "created_at": "2026-04-01T09:15:00Z",
      "currency": "EUR",
      "end_date": "2026-08-01T00:00:00Z",
      "location_type": "global",
      "name": "Q2 EMEA enterprise push",
      "start_date": "2026-05-01T00:00:00Z",
      "status": "draft",
      "total_budget": 1000,
      "updated_at": "2026-04-12T11:30:00Z"
    },
    "id": "1234",
    "relationships": {
      "campaign_locations": [
        {
          "id": "98765"
        }
      ],
      "campaign_settings": {
        "id": "1234"
      },
      "campaign_summary": {
        "id": "1234"
      },
      "created_by": {
        "id": "12345"
      },
      "custom_feed": {
        "id": "feed-100"
      },
      "list": {
        "id": "company_42"
      }
    },
    "type": "campaign"
  },
  "meta": {
    "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
  }
}

Changes

  • 1bcf34d73cd0Revision changes
    • info

      added the optional property //////// to the response with the status

  • ac752c6c2be0Revision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status