1. Campaigns
Leadfeeder API
  • Introduction
  • Authentication
  • Getting Started
  • Rate Limits
  • Relationships
  • Company ID Lifecycle
  • OpenAPI Specification Access
  • List of NACE / WZ codes
  • List of Industries
  • Account
    • List Accounts
  • Companies
    • Get Company Details
    • Retrieve Companies
    • Company Financial Reports
    • Search Company Signals
    • Search Companies
    • Match Companies
    • Retrieve Company IPs
    • Add Company to Lists
    • Remove Company from Lists
    • Assign Tags to Company
    • Unassign Tags from Company
    • Estimate Company Enrichment Job
    • Create Company Enrichment Job
    • Get Company Enrichment Job Status
  • Contacts
    • Get Contact Details
    • Retrieve Contacts
    • Search Contacts
    • Add Contact to Lists
    • Remove Contact from Lists
    • Estimate Find Contact Data Job
    • Create Find Contact Data Job
    • Get Find Contact Data Job Status
  • Web Visits
    • Custom Feed - Filter Reference
    • How to Create Custom Feed
    • Search Web Visits
    • Retrieve Custom Feeds
    • Create a Custom Feed
    • Get Custom Feed Details
    • Update Custom Feed
    • Delete a Custom Feed
    • Retrieve Custom Feeds Folders
    • Retrieve Web Visits Tracker Script
    • Retrieve Visitor Companies
  • Campaigns
    • Retrieve Campaigns
      GET
    • Get Campaign Details
      GET
    • Update Campaign
      PATCH
    • Retrieve Campaign Stats
      GET
  • IP
    • Enrich Company IP Address
  • Buyer Personas
    • Retrieve Buyer Personas
    • Get Buyer Persona Details
  • Ideal Customer Profiles
    • Retrieve Ideal Customer Profiles
    • Get Ideal Customer Profile Details
  • Tags
    • Retrieve Tags
    • Create Tag
    • Get Tag Details
    • Update Tag
    • Delete Tag
  • Lists
    • Retrieve Lists
    • Create a List
    • Get List Details
    • Update List
    • Delete List
  • Custom Fields
    • Retrieve Custom Fields
    • Create Custom Field
    • Get Custom Field Details
    • Update Custom Field
    • Delete Custom Field
  • Usage
    • Get Endpoints Usage
  • Schemas
    • AccountV1
    • AccountSummaryV1
    • ErrorObjectV1
    • CompanyV1
    • TagV1
    • ListV1
    • VisitLocationV1
    • WebVisitV1
    • CRMUserV1
    • CRMOrganizationV1
    • CRMContactV1
    • CRMLeadV1
    • CRMConnectionV1
    • CRMSuggestionV1
    • CRMGroupConnectionV1
    • ICPV1
    • CompanyFinancialsV1
    • IpAddressExtendedV1
    • CompanyIpV1
    • SignalV1
    • CompanySummaryV1
    • MaskedCompanySummaryV1
    • CompanyMatchV1
    • EnrichmentJobV1
    • BuyerPersonaV1
    • ContactV1
    • ContactSummaryV1
    • MaskedContactSummaryV1
    • FindContactDataJobV1
    • CustomFieldV1
    • CustomFeedV1
    • CampaignSettingsV1
    • CampaignSummaryV1
    • CampaignLocationV1
    • CampaignV1
    • CampaignStatsV1
    • IpLocationV1
    • NetworkV1
    • EnrichedIpV1
    • ApiUsageV1
    • CustomFeedRequestV1
    • CustomFeedFolderV1
    • WebVisitsTrackerScriptV1
    • LocationV1
    • CompanyLocationV1
  1. Campaigns

Retrieve Campaigns

GET
/v1/campaigns
Retrieve the list of all campaigns available in the account. Use pagination to control the number of campaigns returned, and include related campaign data, campaign settings, list, or custom feed information when needed.

Request

Authorization
API Key
Add parameter in header
X-Api-Key
Example:
X-Api-Key: ********************
or
Query Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --globoff 'https://api.leadfeeder.com/v1/campaigns?account_id=123456&page[num]=1&page[size]=20&include=campaign_summary%2Ccampaign_settings%2Ccampaign_locations%2Clist%2Ccustom_feed' \
--header 'X-Api-Key: <api-key>'

Responses

🟢200OK
application/json
Success
Bodyapplication/json

Example
{
    "data": [
        {
            "type": "campaign",
            "id": "1234",
            "attributes": {
                "name": "Q2 EMEA enterprise push",
                "status": "running",
                "start_date": "2026-05-01T00:00:00Z",
                "end_date": "2026-08-01T00:00:00Z",
                "location_type": "country",
                "budget_type": "total",
                "budget": 25000,
                "total_budget": 25000,
                "budget_spent": 4231.55,
                "budget_left": 20768.45,
                "currency": "EUR",
                "can_be_started": true,
                "targets_crm_open_opportunities": false,
                "created_at": "2026-04-01T09:15:00Z",
                "updated_at": "2026-05-10T12:00:00Z"
            },
            "relationships": {
                "created_by": {
                    "id": "12345",
                    "type": "user"
                },
                "list": {
                    "id": "company_42",
                    "type": "list"
                },
                "custom_feed": {
                    "id": "feed-100",
                    "type": "custom_feed"
                },
                "campaign_settings": {
                    "id": "1234",
                    "type": "campaign_settings"
                },
                "campaign_summary": {
                    "id": "1234",
                    "type": "campaign_summary"
                },
                "campaign_locations": [
                    {
                        "id": "98765",
                        "type": "campaign_location"
                    }
                ]
            }
        },
        {
            "type": "campaign",
            "id": "1233",
            "attributes": {
                "name": "Q1 DACH retargeting",
                "status": "ended",
                "start_date": "2026-01-15T00:00:00Z",
                "end_date": "2026-03-31T00:00:00Z",
                "location_type": "country",
                "budget_type": "daily",
                "budget": 200,
                "total_budget": 15400,
                "budget_spent": 15400,
                "budget_left": 0,
                "currency": "EUR",
                "can_be_started": false,
                "targets_crm_open_opportunities": false,
                "created_at": "2026-01-10T08:00:00Z",
                "updated_at": "2026-04-01T00:05:00Z"
            },
            "relationships": {
                "created_by": {
                    "id": "12345",
                    "type": "user"
                },
                "list": {
                    "id": "company_77",
                    "type": "list"
                },
                "custom_feed": null,
                "campaign_settings": {
                    "id": "1233",
                    "type": "campaign_settings"
                },
                "campaign_summary": {
                    "id": "1233",
                    "type": "campaign_summary"
                },
                "campaign_locations": [
                    {
                        "id": "11111",
                        "type": "campaign_location"
                    },
                    {
                        "id": "11112",
                        "type": "campaign_location"
                    }
                ]
            }
        }
    ],
    "meta": {
        "pagination": {
            "page_num": 1,
            "page_count": 1,
            "total_count": 2
        },
        "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
    }
}
🟠400Bad Request
🟠403Forbidden
🟠429
🔴500Server Error
🔴504Gateway Timeout
Modified at 2026-05-29 11:56:07
Previous
Retrieve Visitor Companies
Next
Get Campaign Details
Built with