Accounts and SettingsExternal Feeds

Get all external feeds

Retrieves all external feeds from your Brevo account with filtering and pagination. **Use this to:** - Get an overview of all external data feeds - Find feeds by name using search functionality - Filter feeds by creation date range - Browse feeds by authentication type - Monitor feed library organization and usage **Key information returned:** - Feed details (UUID, name, URL, authentication type) - Feed configuration and settings - Creation and modification timestamps - Feed status and error information - Authentication and header configurations **Important considerations:** - External feeds enable dynamic content in email campaigns - Feeds must be accessible from Brevo servers - Authentication credentials are securely stored - Feed performance affects campaign delivery - Use pagination for accounts with many feeds - Date range filtering limited to 30 days maximum - Search functionality works on feed name matching - Internal feeds are system-managed and cannot be modified

Authentication

api-keystring

The API key should be passed in the request headers as api-key for authentication.

Query parameters

searchstringOptional
Can be used to filter records by search keyword on feed name
startDatedateOptional

Mandatory if endDate is used. Starting date (YYYY-MM-DD) from which you want to fetch the list. Can be maximum 30 days older than current date.

endDatedateOptional

Mandatory if startDate is used. Ending date (YYYY-MM-DD) till which you want to fetch the list. Maximum time period that can be selected is one month.

sortenumOptionalDefaults to desc

Sort the results in the ascending/descending order of record creation. Default order is descending if sort is not passed.

Allowed values:
authTypeenumOptional

Filter the records by authType of the feed.

Allowed values:
limitlongOptionalDefaults to 50
Number of documents returned per page.
offsetlongOptionalDefaults to 0
Index of the first document on the page.

Response

External feeds retrieved successfully
countinteger
Total number of feeds
feedslist of objects
List of external feeds

Errors