v3

latestOpenAPI 3.1.1mit2026-07-3165481.5 MB
Web Visits
v1

Retrieve Custom Feeds

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

Query parameters

account_idstring required

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

include'folder'

Specify which additional data should be attached to the result.

Response

Success

Example response

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