> 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 contacts in a list GET https://api.brevo.com/v3/contacts/lists/{listId}/contacts Retrieve all contacts belonging to a specific list, identified by its list ID. Results are paginated with a default of 50 contacts per page (maximum 500) and sorted in descending order of creation. You can optionally filter contacts by their modification date using the modifiedSince parameter. Reference: https://developers.brevo.com/reference/get-contacts-from-list ## Authentication - `api-key` header (required) — The API key should be passed in the request headers as `api-key` for authentication. ## Request ### Path parameters - `listId` (long, required) — Id of the list ### Query parameters - `modifiedSince` (string, optional) — Filter (urlencoded) the contacts modified after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). **Prefer to pass your timezone in date-time format for accurate result.** - `limit` (long, optional, default: 50) — Number of documents per page - `offset` (long, optional, default: 0) — Index of the first document of the page - `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` ## Response ### 200 Contact informations - `contacts` (list of object, required) - `attributes` (object, required) — Set of attributes of the contact - `createdAt` (string, required) — Creation UTC date-time of the contact (YYYY-MM-DDTHH:mm:ss.SSSZ) - `emailBlacklisted` (boolean, required) — Blacklist status for email campaigns (true=blacklisted, false=not blacklisted) - `id` (long, required) — ID of the contact for which you requested the details - `listIds` (list of long, required) - `modifiedAt` (string, required) — Last modification UTC date-time of the contact (YYYY-MM-DDTHH:mm:ss.SSSZ) - `smsBlacklisted` (boolean, required) — Blacklist status for SMS campaigns (true=blacklisted, false=not blacklisted) - `whatsappBlacklisted` (boolean, required) — Blacklist status for WhatsApp campaigns (true=blacklisted, false=not blacklisted) - `email` (string, optional) — Email address of the contact for which you requested the details - `listUnsubscribed` (list of long, optional) - `consentGroups` (list of object, optional) — Consent groups the contact belongs to, with their subscription status. Only present when the Consent Groups feature is enabled for your account. - `id` (long, required) — ID of the consent group - `status` (enum, required) — The contact's subscription status within this consent group - Allowed values: `subscribed`, `unsubscribed` - `count` (long, required) — Number of contacts ## 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 List ID not found - `message` (string, required) — Readable message associated to the failure - `code` (string, optional) — Error code displayed in case of a failure ### 429 Too Many Requests Error Too Many Requests - `message` (string, required) — Readable message associated to the failure - `code` (string, optional) — Error code displayed in case of a failure ## Examples **Response** ```json { "contacts": [ { "attributes": { "DOB": "2010-12-31", "FIRSTNAME": "Alex", "GENDER": "Kid", "LASTNAME": "Pain" }, "createdAt": "2017-05-12T12:30:00Z", "emailBlacklisted": false, "id": 45, "listIds": [ 12, 9, 20 ], "modifiedAt": "2017-05-12T12:30:00Z", "smsBlacklisted": true, "whatsappBlacklisted": false, "email": "alex.pain@example.com", "listUnsubscribed": [ 1, 2 ] }, { "attributes": { "DOB": "1986-06-21", "FIRSTNAME": "John", "GENDER": "Men", "LASTNAME": "Smith" }, "createdAt": "2017-05-12T12:30:00Z", "emailBlacklisted": true, "id": 32, "listIds": [ 12 ], "modifiedAt": "2017-05-12T12:30:00Z", "smsBlacklisted": false, "whatsappBlacklisted": false, "email": "john.smith@example.com", "listUnsubscribed": [ 1 ] }, { "attributes": { "DOB": "1988-11-02", "FIRSTNAME": "Helen", "GENDER": "Women", "LASTNAME": "Rose", "SMS": "3375599887766" }, "createdAt": "2017-05-12T12:30:00Z", "emailBlacklisted": true, "id": 65, "listIds": [ 12, 9, 20 ], "modifiedAt": "2017-05-12T12:30:00Z", "smsBlacklisted": false, "whatsappBlacklisted": false, "email": "helen.rose@example.com", "listUnsubscribed": [ 1 ] } ], "count": 17655 } ``` **SDK Code** ```typescript response import { BrevoClient } from "@getbrevo/brevo"; async function main() { const client = new BrevoClient({ apiKey: "YOUR_API_KEY_HERE", }); await client.contacts.getContactsFromList({ listId: 1, }); } main(); ``` ```python response from brevo import Brevo client = Brevo( api_key="YOUR_API_KEY_HERE", ) client.contacts.get_contacts_from_list( list_id=1, ) ``` ```php response contacts->getContactsFromList( 1, new GetContactsFromListRequest([]), ); ``` ```go response package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api.brevo.com/v3/contacts/lists/1/contacts" 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 response require 'uri' require 'net/http' url = URI("https://api.brevo.com/v3/contacts/lists/1/contacts") 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 response import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://api.brevo.com/v3/contacts/lists/1/contacts") .header("api-key", "") .asString(); ``` ```csharp response using RestSharp; var client = new RestClient("https://api.brevo.com/v3/contacts/lists/1/contacts"); var request = new RestRequest(Method.GET); request.AddHeader("api-key", ""); IRestResponse response = client.Execute(request); ``` ```swift response import Foundation let headers = ["api-key": ""] let request = NSMutableURLRequest(url: NSURL(string: "https://api.brevo.com/v3/contacts/lists/1/contacts")! 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() ```