Leadfeeder API
    • Leadfeeder API
    • Authentication
    • Getting Started
    • Rate Limits
    • Relationships
    • Company ID Lifecycle
    • OpenAPI Specification Access
    • List of NACE / WZ codes
    • List of Industries
    • AI & MCP (Beta)
      • Overview of the Leadfeeder MCP Server
      • Quickstart
      • Connect your AI tool
      • Authentication and permissions
    • Account
      • List Accounts
    • Companies
      • Get Company Details
      • Update a Company
      • Retrieve Companies
      • Company Financial Reports
      • Retrieve Company IPs
      • Search Company Signals
      • Search Companies
      • Match Companies
      • 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
      • Update a Contact
      • 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
      • How to Create Custom Feed
      • Custom Feed - Filter Reference
      • 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 Campaign Details
      • Update Campaign
      • Retrieve Campaign Stats
    • IP
      • Enrich Company IP Address
    • Buyer Personas
      • Retrieve Buyer Personas
      • Create a Buyer Persona
      • Get Buyer Persona Details
      • Update a Buyer Persona
      • Delete a Buyer Persona
    • Ideal Customer Profiles
      • Retrieve Ideal Customer Profiles
      • Create an Ideal Customer Profile
      • Get Ideal Customer Profile Details
      • Update an Ideal Customer Profile
      • Delete an Ideal Customer Profile
      • Retrieve Company ICP Matches
    • Tags
      • Retrieve Tags
      • Create Tag
      • Get Tag Details
      • Update Tag
      • Delete Tag
      • Create Batch Add Tags Job
      • Get Batch Add Tags Job
      • Create Batch Remove Tags Job
      • Get Batch Remove Tags Job
    • Lists
      • Retrieve Lists
      • Create a List
      • Get List Details
      • Update List
      • Delete List
      • Retrieve List Items
      • Retrieve Company List Memberships
      • Retrieve Contact List Memberships
      • Create Batch Add to List Job
      • Get Batch Add to List Job
      • Create Batch Remove from List Job
      • Get Batch Remove from List Job
    • Custom Fields
      • Retrieve Custom Fields
      • Create Custom Field
      • Get Custom Field Details
      • Update Custom Field
      • Delete Custom Field
    • Users
      • Get Current User
    • Usage
      • Get Endpoints Usage
    • Reference Data
      • Get Geo Suggestions
      • Get Countries with Regions
    • Settings
      • Get Data Processing Settings
      • Update Data Processing Settings
      • Get Cookie Consent Settings
      • Update Cookie Consent Settings
    • Schemas
      • AccountCompanyV1
      • AccountV1
      • AccountSummaryV1
      • CompanyV1
      • ErrorObjectV1
      • ICPV1
      • IpAddressExtendedV1
      • CompanyFinancialsV1
      • UserV1
      • CompanySummaryV1
      • CompaniesAdvancedSearchFilterItem
      • BuyerPersonaV1
      • ContactFilterGroupsV1
      • EnrichmentJobV1
      • ContactV1
      • ContactSummaryV1
      • GeoSuggestionV1
      • TagV1
      • MaskedContactSummaryV1
      • ListV1
      • IcpRequestV1
      • VisitLocationV1
      • WebVisitV1
      • BatchAddTagsJobV1
      • BatchRemoveTagsJobV1
      • CRMUserV1
      • BuyerPersonaRequestV1
      • CRMOrganizationV1
      • EnrichedIpV1
      • CRMContactV1
      • CampaignSummaryV1
      • CRMLeadV1
      • CampaignV1
      • CustomFeedRequestV1
      • CRMConnectionV1
      • CampaignStatsV1
      • CRMSuggestionV1
      • CRMGroupConnectionV1
      • WebVisitsTrackerScriptV1
      • CompanyIpV1
      • SignalV1
      • MaskedCompanySummaryV1
      • CompanyMatchV1
      • CountryV1
      • CookieConsentSettingsV1
      • DataProcessingSettingsV1
      • FindContactDataJobV1
      • BatchAddToListJobV1
      • CustomFieldV1
      • BatchRemoveFromListJobV1
      • CustomFeedV1
      • CampaignSettingsV1
      • CampaignLocationV1
      • IpLocationV1
      • NetworkV1
      • ApiUsageV1
      • CustomFeedFolderV1
      • LocationV1
      • CompanyLocationV1

    Getting Started

    The Leadfeeder API enables you to programmatically access company and contact intelligence, website visitor data, and manage your workflow objects. This guide walks you through the initial setup to start making your first API requests.

    Prerequisites#

    Before you begin, ensure you have:
    An active Leadfeeder account
    🚀
    Don't have a Leadfeeder account yet?
    Start a free 14-day trial — no credit card required. Once your account is active, come back to Step 1 to generate your API key.
    User permissions to generate API keys
    A development environment capable of making HTTPS requests

    Step 1: Generate Your API Key#

    Each Leadfeeder user can generate their own API keys for authentication.
    To create an API key:
    1.
    Log in to the Leadfeeder platform
    2.
    Navigate to Settings ⚙ → Personal → API Keys
    3.
    Click Create a new API key
    4.
    Copy and securely store your API key
    Note: If you do not see the API keys section, contact your account administrator to grant the necessary permissions.
    For detailed information on how to configure authentication in your requests, see Authentication.

    Step 2: Find Your Account ID#

    Most API endpoints require an account_id parameter to specify which account's data you want to access. Your user may have access to multiple Leadfeeder accounts.

    Option A: Copy it from the app#

    1.
    Go to Settings ⚙ → Account or directly click on https://app.leadfeeder.com/l/settings/website/
    2.
    In the General section, find Account ID.
    3.
    Click the copy button next to it.
    The ID is now on your clipboard, ready to paste into a request or a prompt.

    Option B: Call the List Accounts endpoint#

    Use this when your API key has access to several accounts and you want them all
    in one response.
    Request
    Response
    {
      "data": [
        {
          "type": "account_summary",
          "id": "123456",
          "attributes": {
            "name": "Account 1"
          }
        },
        {
          "type": "account_summary",
          "id": "789012",
          "attributes": {
            "name": "Account 2"
          }
        }
      ],
      "meta": {
        "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
      }
    }
    The id field contains your account_id.

    Get Account Details with Credit Information##

    To retrieve detailed information about a specific account, including credit usage:
    Request
    Response
    {
      "data": [
        {
          "type": "account",
          "id": "123456",
          "attributes": {
            "name": "Account 1",
            "credits": {
              "available": 1000,
              "used": 200,
              "remaining": 800,
              "next_reset_on": "2026-10-01"
            }
          }
        }
      ],
      "meta": {
        "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
      }
    }

    Step 3: Make Your First API Request#

    Once you have your API key and account ID, you can start making requests to the API.

    Example: Search for Companies#

    Let's search for companies in a specific location and industry:
    Request
    Response
    {
      "data": [
        {
          "type": "company_summary",
          "id": "159001425",
          "attributes": {
            "name": "Example Company Ltd",
            "role": "group_member",
            "register": {
              "status": "active"
            },
            "meta": {
              "do_not_contact": false,
              "has_phones": true,
              "has_mail": true,
              "has_contacts": true
            }
          }
        }
      ],
      "meta": {
        "credits": {
          "charged": 0
        },
        "pagination": {
          "next_cursor": "dXNlcjpVMEc5V0ZYTlo",
          "total_count": 145
        },
        "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
      }
    }

    Understanding the account_id Parameter#

    The account_id is a required parameter for most API endpoints. It determines:
    Which account's data is accessed
    Which credit pool is used for requests that consume credits
    Which permissions and access levels apply

    Don't have an account yet?#

    Start a free trial
    No Leadfeeder account yet? Create one in a few minutes and get your API key and account ID.
    Book a demo
    We advise you individually about your unique use cases and act as a partner to answer all your questions.
    Modified at 2026-08-20 11:34:30
    Previous
    Authentication
    Next
    Rate Limits
    Built with