LEleadfeeder
Web Visits
v1

Retrieve Custom Feeds

Changed on

Retrieve all custom feeds accessible to the current user for the given account.

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

get/v1/web-visits/custom-feeds

Request

  • Base URL
    https://api.leadfeeder.com
  • URL
    https://api.leadfeeder.com/v1/web-visits/custom-feeds
  • 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: web_visits:read

Query parameters

account_idstring required

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

include'folder' | 'connected_list'

Specify which additional data should be attached to the result.

filter[has_connected_list]boolean

When true, return only custom feeds connected to a Leadfeeder list. Omit or set to false to return all custom feeds.

Response

Success

Example response

{
  "data": [
    {
      "attributes": {
        "advanced_filters": {
          "items": [
            {
              "display_value": "Germany",
              "field": "country_code",
              "operator": "includes",
              "type": "filter"
            }
          ],
          "operator": "and",
          "type": "group"
        },
        "created_at": "2026-01-15T10:30:00.000Z",
        "deletable": true,
        "name": "All companies",
        "notifications": [
          {
            "medium": "email",
            "sending_interval": "day",
            "user_id": 12345
          }
        ],
        "updated_at": "2026-01-20T14:00:00.000Z",
        "viewable": true
      },
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "relationships": {
        "connected_list": {
          "id": "512"
        },
        "created_by": {
          "id": "12345"
        },
        "folder": {
          "id": "42",
          "type": "custom_feed_folder"
        }
      },
      "type": "custom_feed"
    }
  ],
  "meta": {
    "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
  }
}

Changes

  • 1bcf34d73cd0Revision changes
    • info

      added the new optional query request parameter filter[has_connected_list]

    • info

      added the new enum value connected_list to the query request parameter include

    • 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