> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://developers.brevo.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.brevo.com/_mcp/server. # Get all external feeds GET https://api.brevo.com/v3/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 Reference: https://developers.brevo.com/reference/get-all-external-feeds ## Authentication - `api-key` header (required) — The API key should be passed in the request headers as `api-key` for authentication. ## Request ### Query parameters - `search` (string, optional) — Can be used to filter records by search keyword on feed name - `startDate` (date, optional) — 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. - `endDate` (date, optional) — 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. - `sort` (enum, optional, default: desc) — Sort the results in the ascending/descending order of record creation. Default order is **descending** if `sort` is not passed. - Allowed values: `asc`, `desc` - `authType` (enum, optional) — Filter the records by `authType` of the feed. - Allowed values: `basic`, `token`, `noAuth` - `limit` (long, optional, default: 50) — Number of documents returned per page. - `offset` (long, optional, default: 0) — Index of the first document on the page. ## Response ### 200 External feeds retrieved successfully - `count` (integer, required) — Total number of feeds - `feeds` (list of object, required) — List of external feeds - `id` (string, required) — Unique identifier of the feed - `name` (string, required) — Name of the feed - `url` (string, required) — URL of the external data source - `authType` (enum, required) — Authentication type for accessing the feed - Allowed values: `basic`, `token`, `noAuth` - `maxRetries` (integer, required) — Maximum number of retry attempts for failed requests - `cache` (boolean, required) — Whether to cache the feed response - `createdAt` (datetime, required) — Feed creation timestamp - `modifiedAt` (datetime, required) — Feed last modification timestamp - `username` (string, optional) — Username for basic authentication. Only returned when authType is 'basic'. Excluded when authType is 'token'. - `password` (string, optional) — Password for basic authentication. Only returned when authType is 'basic'. Excluded when authType is 'token'. - `token` (string, optional) — Token for token-based authentication. Only returned when authType is 'token'. Excluded when authType is 'basic' or 'noAuth'. - `headers` (list of object, optional, nullable) — Custom HTTP headers for the feed request - `name` (string, required) — Header name - `value` (string, required) — Header value ## Errors ### 400 Bad Request Error bad request - `code` (enum, required) — Error code displayed in case of a failure - Allowed values: `invalid_parameter`, `missing_parameter`, `out_of_range`, `campaign_processing`, `campaign_sent`, `document_not_found`, `not_enough_credits`, `permission_denied`, `duplicate_parameter`, `duplicate_request`, `method_not_allowed`, `unauthorized`, `account_under_validation`, `not_acceptable`, `bad_request`, `unprocessable_entity`, `Domain does not exist`, `Contact email not found`, `Attribute not found`, `Category id not found`, `Invalid parameters passed`, `Record(s) for identifier not found`, `Returned when query params are invalid`, `Returned when invalid data posted`, `Feed not found`, `Campaign ID not found`, `api-key not found`, `DMARC policy requires domain authentication`, `DNS records not properly configured`, `Invalid OTP code provided`, `OTP code has expired`, `Domain already exists in your account`, `The sum of all IP weights must equal 100`, `Authentication failed`, `Insufficient credits`, `Request already processed` - `message` (string, required) — Readable message associated to the failure ### 404 Not Found Error Record not found - `message` (string, required) — Readable message associated to the failure - `code` (string, optional) — Error code displayed in case of a failure ## Examples **Response** ```json { "count": 18, "feeds": [ { "id": "b1c2d3e4-f5a6-47b8-89c0-d1e2f3a4b5c6", "name": "Product Catalog Feed", "url": "https://api.example.com/products", "authType": "noAuth", "maxRetries": 3, "cache": true, "createdAt": "2025-09-18T13:29:27.208Z", "modifiedAt": "2025-09-18T13:29:27.208Z" }, { "id": "c2d3e4f5-a6b7-48c9-90d1-e2f3a4b5c6d7", "name": "Blog News Feed", "url": "https://blog.example.com/api/posts", "authType": "token", "maxRetries": 3, "cache": true, "createdAt": "2025-09-17T16:03:25.826Z", "modifiedAt": "2025-09-17T16:03:25.826Z", "token": "abc123token456" }, { "id": "d3e4f5a6-b7c8-49d0-91e2-f3a4b5c6d7e8", "name": "Public Data Feed", "url": "https://jsonplaceholder.typicode.com/posts", "authType": "basic", "maxRetries": 3, "cache": true, "createdAt": "2025-09-05T09:06:42.848Z", "modifiedAt": "2025-09-05T09:06:42.848Z", "username": "apiuser", "password": "apipass" } ] } ``` **SDK Code** ```typescript List of external feeds with various configurations import { BrevoClient } from "@getbrevo/brevo"; async function main() { const client = new BrevoClient({ apiKey: "YOUR_API_KEY_HERE", }); await client.externalFeeds.getAllExternalFeeds({ endDate: "2024-01-31", limit: 50, offset: 0, search: "product", startDate: "2024-01-01", }); } main(); ``` ```python List of external feeds with various configurations from brevo import Brevo import datetime client = Brevo( api_key="YOUR_API_KEY_HERE", ) client.external_feeds.get_all_external_feeds( end_date=datetime.date.fromisoformat("2024-01-31"), limit=50, offset=0, search="product", start_date=datetime.date.fromisoformat("2024-01-01"), ) ``` ```php List of external feeds with various configurations externalFeeds->getAllExternalFeeds( new GetAllExternalFeedsRequest([ 'endDate' => new DateTime('2024-01-31'), 'limit' => 50, 'offset' => 0, 'search' => 'product', 'startDate' => new DateTime('2024-01-01'), ]), ); ``` ```go List of external feeds with various configurations package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api.brevo.com/v3/feeds?endDate=2024-01-31&limit=50&offset=0&search=product&startDate=2024-01-01" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("api-key", "") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby List of external feeds with various configurations require 'uri' require 'net/http' url = URI("https://api.brevo.com/v3/feeds?endDate=2024-01-31&limit=50&offset=0&search=product&startDate=2024-01-01") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["api-key"] = '' response = http.request(request) puts response.read_body ``` ```java List of external feeds with various configurations import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://api.brevo.com/v3/feeds?endDate=2024-01-31&limit=50&offset=0&search=product&startDate=2024-01-01") .header("api-key", "") .asString(); ``` ```csharp List of external feeds with various configurations using RestSharp; var client = new RestClient("https://api.brevo.com/v3/feeds?endDate=2024-01-31&limit=50&offset=0&search=product&startDate=2024-01-01"); var request = new RestRequest(Method.GET); request.AddHeader("api-key", ""); IRestResponse response = client.Execute(request); ``` ```swift List of external feeds with various configurations import Foundation let headers = ["api-key": ""] let request = NSMutableURLRequest(url: NSURL(string: "https://api.brevo.com/v3/feeds?endDate=2024-01-31&limit=50&offset=0&search=product&startDate=2024-01-01")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```