{
  "service": "leadfeeder",
  "displayName": "Leadfeeder",
  "categories": [
    "Marketing",
    "Data"
  ],
  "authTypes": [
    "api_key"
  ],
  "auth": [
    {
      "type": "api_key",
      "label": "API Key",
      "placeholder": "LEADFEEDER_API_KEY",
      "description": "Leadfeeder API key sent with the X-Api-Key header. Create it in Leadfeeder under Settings > Personal > API Keys."
    }
  ],
  "homepageUrl": "https://www.leadfeeder.com",
  "actions": [
    {
      "id": "leadfeeder.enrich_ip",
      "service": "leadfeeder",
      "name": "enrich_ip",
      "description": "Enrich one IPv4 or IPv6 address with Leadfeeder company or network intelligence.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "accountId": {
            "type": "string",
            "minLength": 1,
            "description": "The Leadfeeder account ID. Retrieve available account IDs with list_accounts."
          },
          "ip": {
            "type": "string",
            "minLength": 1,
            "description": "A valid IPv4 or IPv6 address to enrich."
          }
        },
        "additionalProperties": false,
        "description": "Request parameters for enriching one IP address."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "description": "The Leadfeeder resource type."
              },
              "id": {
                "type": "string",
                "description": "The Leadfeeder resource ID."
              },
              "attributes": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "The attributes returned for this Leadfeeder resource."
              },
              "relationships": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "The relationships returned for this Leadfeeder resource."
              }
            },
            "additionalProperties": true,
            "description": "A Leadfeeder JSON:API resource object."
          },
          "meta": {
            "type": "object",
            "properties": {
              "request_id": {
                "type": "string",
                "description": "The unique request ID assigned by Leadfeeder."
              },
              "credits": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "Credit consumption metadata returned by Leadfeeder."
              },
              "pagination": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "Pagination metadata returned by Leadfeeder."
              },
              "num_results": {
                "type": "integer",
                "description": "The number of results returned by Leadfeeder."
              }
            },
            "additionalProperties": true,
            "description": "Leadfeeder response metadata."
          }
        },
        "additionalProperties": false,
        "description": "A Leadfeeder response containing one JSON:API resource."
      }
    },
    {
      "id": "leadfeeder.get_companies",
      "service": "leadfeeder",
      "name": "get_companies",
      "description": "Fetch detailed Leadfeeder firmographic data for up to 100 company IDs in one request.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "accountId": {
            "type": "string",
            "minLength": 1,
            "description": "The Leadfeeder account ID. Retrieve available account IDs with list_accounts."
          },
          "companyIds": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1,
              "description": "The Leadfeeder company ID. Older string-based company IDs are also supported by Leadfeeder."
            },
            "description": "Leadfeeder company IDs to retrieve.",
            "minItems": 1,
            "maxItems": 100
          },
          "include": {
            "type": "string",
            "enum": [
              "group_company",
              "tags",
              "lists",
              "web_visits",
              "icps",
              "crm_connections",
              "crm_connections.crm_record",
              "crm_connections.crm_record.crm_owner",
              "crm_suggestions",
              "crm_suggestions.crm_record",
              "crm_suggestions.crm_record.crm_owner",
              "crm_group_connections",
              "crm_group_connections.crm_connection",
              "crm_group_connections.crm_connection.crm_record",
              "crm_group_connections.crm_connection.crm_record.crm_owner"
            ],
            "description": "Additional relationship data to attach to a company response."
          }
        },
        "additionalProperties": false,
        "required": [
          "accountId",
          "companyIds"
        ],
        "description": "Request parameters for retrieving multiple Leadfeeder companies."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "description": "The Leadfeeder resource type."
                },
                "id": {
                  "type": "string",
                  "description": "The Leadfeeder resource ID."
                },
                "attributes": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "The attributes returned for this Leadfeeder resource."
                },
                "relationships": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "The relationships returned for this Leadfeeder resource."
                }
              },
              "additionalProperties": true,
              "description": "A Leadfeeder JSON:API resource object."
            },
            "description": "The Leadfeeder resources returned by the API."
          },
          "meta": {
            "type": "object",
            "properties": {
              "request_id": {
                "type": "string",
                "description": "The unique request ID assigned by Leadfeeder."
              },
              "credits": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "Credit consumption metadata returned by Leadfeeder."
              },
              "pagination": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "Pagination metadata returned by Leadfeeder."
              },
              "num_results": {
                "type": "integer",
                "description": "The number of results returned by Leadfeeder."
              }
            },
            "additionalProperties": true,
            "description": "Leadfeeder response metadata."
          }
        },
        "additionalProperties": false,
        "description": "A Leadfeeder response containing an array of JSON:API resources."
      }
    },
    {
      "id": "leadfeeder.get_company",
      "service": "leadfeeder",
      "name": "get_company",
      "description": "Fetch detailed Leadfeeder firmographic and hierarchy data for one company ID.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "accountId": {
            "type": "string",
            "minLength": 1,
            "description": "The Leadfeeder account ID. Retrieve available account IDs with list_accounts."
          },
          "companyId": {
            "type": "string",
            "minLength": 1,
            "description": "The Leadfeeder company ID. Older string-based company IDs are also supported by Leadfeeder."
          },
          "include": {
            "type": "string",
            "enum": [
              "group_company",
              "tags",
              "lists",
              "web_visits",
              "icps",
              "crm_connections",
              "crm_connections.crm_record",
              "crm_connections.crm_record.crm_owner",
              "crm_suggestions",
              "crm_suggestions.crm_record",
              "crm_suggestions.crm_record.crm_owner",
              "crm_group_connections",
              "crm_group_connections.crm_connection",
              "crm_group_connections.crm_connection.crm_record",
              "crm_group_connections.crm_connection.crm_record.crm_owner"
            ],
            "description": "Additional relationship data to attach to a company response."
          }
        },
        "additionalProperties": false,
        "required": [
          "accountId",
          "companyId"
        ],
        "description": "Request parameters for retrieving one Leadfeeder company."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "description": "The Leadfeeder resource type."
              },
              "id": {
                "type": "string",
                "description": "The Leadfeeder resource ID."
              },
              "attributes": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "The attributes returned for this Leadfeeder resource."
              },
              "relationships": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "The relationships returned for this Leadfeeder resource."
              }
            },
            "additionalProperties": true,
            "description": "A Leadfeeder JSON:API resource object."
          },
          "meta": {
            "type": "object",
            "properties": {
              "request_id": {
                "type": "string",
                "description": "The unique request ID assigned by Leadfeeder."
              },
              "credits": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "Credit consumption metadata returned by Leadfeeder."
              },
              "pagination": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "Pagination metadata returned by Leadfeeder."
              },
              "num_results": {
                "type": "integer",
                "description": "The number of results returned by Leadfeeder."
              }
            },
            "additionalProperties": true,
            "description": "Leadfeeder response metadata."
          }
        },
        "additionalProperties": false,
        "description": "A Leadfeeder response containing one JSON:API resource."
      }
    },
    {
      "id": "leadfeeder.get_current_user",
      "service": "leadfeeder",
      "name": "get_current_user",
      "description": "Retrieve the Leadfeeder user associated with the connected API key.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false,
        "description": "Request parameters for retrieving the current Leadfeeder user."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "description": "The Leadfeeder resource type."
              },
              "id": {
                "type": "string",
                "description": "The Leadfeeder resource ID."
              },
              "attributes": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "The attributes returned for this Leadfeeder resource."
              },
              "relationships": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "The relationships returned for this Leadfeeder resource."
              }
            },
            "additionalProperties": true,
            "description": "A Leadfeeder JSON:API resource object."
          },
          "meta": {
            "type": "object",
            "properties": {
              "request_id": {
                "type": "string",
                "description": "The unique request ID assigned by Leadfeeder."
              },
              "credits": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "Credit consumption metadata returned by Leadfeeder."
              },
              "pagination": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "Pagination metadata returned by Leadfeeder."
              },
              "num_results": {
                "type": "integer",
                "description": "The number of results returned by Leadfeeder."
              }
            },
            "additionalProperties": true,
            "description": "Leadfeeder response metadata."
          }
        },
        "additionalProperties": false,
        "description": "A Leadfeeder response containing one JSON:API resource."
      }
    },
    {
      "id": "leadfeeder.list_accounts",
      "service": "leadfeeder",
      "name": "list_accounts",
      "description": "List Leadfeeder accounts available to the API key, optionally including credit details for one account.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "accountId": {
            "type": "string",
            "minLength": 1,
            "description": "The Leadfeeder account ID. Retrieve available account IDs with list_accounts."
          }
        },
        "additionalProperties": false,
        "description": "Request parameters for listing Leadfeeder accounts."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "description": "The Leadfeeder resource type."
                },
                "id": {
                  "type": "string",
                  "description": "The Leadfeeder resource ID."
                },
                "attributes": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "The attributes returned for this Leadfeeder resource."
                },
                "relationships": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "The relationships returned for this Leadfeeder resource."
                }
              },
              "additionalProperties": true,
              "description": "A Leadfeeder JSON:API resource object."
            },
            "description": "The Leadfeeder resources returned by the API."
          },
          "meta": {
            "type": "object",
            "properties": {
              "request_id": {
                "type": "string",
                "description": "The unique request ID assigned by Leadfeeder."
              },
              "credits": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "Credit consumption metadata returned by Leadfeeder."
              },
              "pagination": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "Pagination metadata returned by Leadfeeder."
              },
              "num_results": {
                "type": "integer",
                "description": "The number of results returned by Leadfeeder."
              }
            },
            "additionalProperties": true,
            "description": "Leadfeeder response metadata."
          }
        },
        "additionalProperties": false,
        "description": "A Leadfeeder response containing an array of JSON:API resources."
      }
    },
    {
      "id": "leadfeeder.match_companies",
      "service": "leadfeeder",
      "name": "match_companies",
      "description": "Match one or more company records to Leadfeeder companies and return ranked matches for each input record.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "accountId": {
            "type": "string",
            "minLength": 1,
            "description": "The Leadfeeder account ID. Retrieve available account IDs with list_accounts."
          },
          "maxResultsPerCompany": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20,
            "description": "Maximum number of Leadfeeder matches returned per input company."
          },
          "companies": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "companyName": {
                  "type": "string",
                  "minLength": 1,
                  "description": "The legal name of the company."
                },
                "url": {
                  "type": "string",
                  "minLength": 1,
                  "description": "The URL of the company website."
                },
                "email": {
                  "type": "string",
                  "minLength": 1,
                  "description": "A company email address."
                },
                "phone": {
                  "type": "string",
                  "minLength": 1,
                  "description": "A company phone number in E.164 format when available."
                },
                "country": {
                  "type": "string",
                  "minLength": 1,
                  "description": "The country name."
                },
                "countryCode": {
                  "type": "string",
                  "minLength": 1,
                  "description": "The ISO 3166-1 alpha-2 country code."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "description": "The city name."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "description": "The postal code for the company's location."
                },
                "street": {
                  "type": "string",
                  "minLength": 1,
                  "description": "The full street address line."
                },
                "streetName": {
                  "type": "string",
                  "minLength": 1,
                  "description": "The street name part of the company's primary address."
                },
                "streetNumber": {
                  "type": "string",
                  "minLength": 1,
                  "description": "The street number part of the company's primary address."
                },
                "registerId": {
                  "type": "string",
                  "minLength": 1,
                  "description": "The company's commercial register identifier."
                },
                "registerLocation": {
                  "type": "string",
                  "minLength": 1,
                  "description": "The company's commercial register location."
                },
                "vatId": {
                  "type": "string",
                  "minLength": 1,
                  "description": "The company's VAT ID or tax ID."
                }
              },
              "additionalProperties": false,
              "description": "A company record to match against Leadfeeder company data. At least one of companyName, url, vatId, or registerId is required."
            },
            "description": "Company records to match.",
            "minItems": 1,
            "maxItems": 200
          }
        },
        "additionalProperties": false,
        "required": [
          "accountId",
          "companies"
        ],
        "description": "Request parameters for matching company records to Leadfeeder companies."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "type": {
                    "type": "string",
                    "description": "The Leadfeeder resource type."
                  },
                  "id": {
                    "type": "string",
                    "description": "The Leadfeeder resource ID."
                  },
                  "attributes": {
                    "type": "object",
                    "properties": {},
                    "additionalProperties": true,
                    "description": "The attributes returned for this Leadfeeder resource."
                  },
                  "relationships": {
                    "type": "object",
                    "properties": {},
                    "additionalProperties": true,
                    "description": "The relationships returned for this Leadfeeder resource."
                  }
                },
                "additionalProperties": true,
                "description": "A Leadfeeder JSON:API resource object."
              },
              "description": "Leadfeeder company match resources for one input company."
            },
            "description": "Match result groups in the same order as the input companies."
          },
          "meta": {
            "type": "object",
            "properties": {
              "request_id": {
                "type": "string",
                "description": "The unique request ID assigned by Leadfeeder."
              },
              "credits": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "Credit consumption metadata returned by Leadfeeder."
              },
              "pagination": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "Pagination metadata returned by Leadfeeder."
              },
              "num_results": {
                "type": "integer",
                "description": "The number of results returned by Leadfeeder."
              }
            },
            "additionalProperties": true,
            "description": "Leadfeeder response metadata."
          }
        },
        "additionalProperties": false,
        "description": "The Leadfeeder company match response."
      }
    },
    {
      "id": "leadfeeder.search_companies",
      "service": "leadfeeder",
      "name": "search_companies",
      "description": "Search Leadfeeder company intelligence using company terms, location, industry, size, revenue, ICP, and boolean filters.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "accountId": {
            "type": "string",
            "minLength": 1,
            "description": "The Leadfeeder account ID. Retrieve available account IDs with list_accounts."
          },
          "pageCursor": {
            "type": "string",
            "minLength": 1,
            "description": "Cursor for retrieving the next page of company search results."
          },
          "pageSize": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "The number of company search results to return. Leadfeeder caps this at 100."
          },
          "searchTerms": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1,
              "description": "A company search term."
            },
            "description": "Strings matched against company names, alternative names, trade names, and domains.",
            "minItems": 1
          },
          "locations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "street": {
                  "type": "string",
                  "minLength": 1,
                  "description": "The full street address line."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "description": "The postal code related to the company's location."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "description": "The city name."
                },
                "countryCode": {
                  "type": "string",
                  "minLength": 1,
                  "description": "The ISO 3166-1 alpha-2 country code."
                },
                "regionCode": {
                  "type": "string",
                  "minLength": 1,
                  "description": "The region code for the company's location."
                },
                "geo": {
                  "type": "object",
                  "properties": {
                    "latitude": {
                      "type": "number",
                      "description": "The latitude of the geographical point."
                    },
                    "longitude": {
                      "type": "number",
                      "description": "The longitude of the geographical point."
                    },
                    "distance": {
                      "type": "number",
                      "minimum": 0,
                      "maximum": 500,
                      "description": "Maximum distance in kilometers from the geographical point."
                    }
                  },
                  "additionalProperties": false,
                  "description": "A geographic radius filter for company search."
                }
              },
              "additionalProperties": false,
              "description": "A company address or geographic filter used by Leadfeeder company search."
            },
            "description": "Company address or geographic filters. Multiple locations are combined as an OR query.",
            "minItems": 1
          },
          "industries": {
            "type": "object",
            "properties": {
              "classification": {
                "type": "string",
                "enum": [
                  "internal",
                  "wz",
                  "nace"
                ],
                "description": "The industry classification system for the supplied codes."
              },
              "codes": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "description": "An industry code."
                },
                "description": "The industry codes to filter companies by.",
                "minItems": 1
              }
            },
            "additionalProperties": false,
            "required": [
              "codes"
            ],
            "description": "Industry classification filters for company search."
          },
          "employeeRanges": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "1-10",
                "11-100",
                "101-500",
                "501-1.000",
                "1.001-5.000",
                "5.001-10.000",
                "10.000+"
              ],
              "description": "An approximate company employee count range."
            },
            "description": "Employee count ranges to filter companies by.",
            "minItems": 1
          },
          "revenue": {
            "type": "object",
            "properties": {
              "min": {
                "type": "integer",
                "minimum": 0,
                "description": "The minimum annual revenue."
              },
              "max": {
                "type": "integer",
                "minimum": 0,
                "description": "The maximum annual revenue."
              }
            },
            "additionalProperties": false,
            "description": "A revenue range filter for companies. At least one of min or max is required when revenue is provided."
          },
          "icpIds": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1,
              "description": "A Leadfeeder Ideal Customer Profile ID."
            },
            "description": "Ideal Customer Profile IDs to use as company search filters.",
            "minItems": 1
          },
          "filters": {
            "type": "object",
            "properties": {
              "hasPhone": {
                "type": "boolean",
                "description": "Whether to return only companies with at least one phone number."
              },
              "hasEmail": {
                "type": "boolean",
                "description": "Whether to return only companies with at least one known email address."
              },
              "hasSocialMediaProfiles": {
                "type": "boolean",
                "description": "Whether to return only companies with at least one social media profile."
              },
              "doNotContact": {
                "type": "boolean",
                "description": "Whether to return only companies marked as do-not-contact."
              },
              "hasFinancialsRevenue": {
                "type": "boolean",
                "description": "Whether to return only companies with known revenue data."
              },
              "hasFinancialsEarnings": {
                "type": "boolean",
                "description": "Whether to return only companies with known earnings data."
              },
              "hasFinancialsNetWorth": {
                "type": "boolean",
                "description": "Whether to return only companies with known net worth data."
              },
              "hasIpAddresses": {
                "type": "boolean",
                "description": "Whether to return only companies with IP address data."
              }
            },
            "additionalProperties": false,
            "description": "Boolean company search filters combined by Leadfeeder using AND."
          }
        },
        "additionalProperties": false,
        "required": [
          "accountId"
        ],
        "description": "Request parameters for searching Leadfeeder companies. At least one search criterion is required."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "description": "The Leadfeeder resource type."
                },
                "id": {
                  "type": "string",
                  "description": "The Leadfeeder resource ID."
                },
                "attributes": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "The attributes returned for this Leadfeeder resource."
                },
                "relationships": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "The relationships returned for this Leadfeeder resource."
                }
              },
              "additionalProperties": true,
              "description": "A Leadfeeder JSON:API resource object."
            },
            "description": "The Leadfeeder resources returned by the API."
          },
          "meta": {
            "type": "object",
            "properties": {
              "request_id": {
                "type": "string",
                "description": "The unique request ID assigned by Leadfeeder."
              },
              "credits": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "Credit consumption metadata returned by Leadfeeder."
              },
              "pagination": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "Pagination metadata returned by Leadfeeder."
              },
              "num_results": {
                "type": "integer",
                "description": "The number of results returned by Leadfeeder."
              }
            },
            "additionalProperties": true,
            "description": "Leadfeeder response metadata."
          }
        },
        "additionalProperties": false,
        "description": "A Leadfeeder response containing an array of JSON:API resources."
      }
    }
  ]
}