Cerca contatti in una lista contatti

GET 
/api/partner-gateway/v1/contacts/list/:listId/contacts

Restituisce i contatti che appartengono a una specifica lista contatti, con filtri opzionali e paginazione. È un endpoint di comodità equivalente a chiamare GET /contacts con il parametro listIds impostato sul listId indicato. Sono disponibili tutti gli stessi filtri a livello di contatto: search (corrispondenza testuale case-insensitive sul nome), gender, isValid (contatto raggiungibile su almeno uno tra telefono ed email), communicationSupported (es. SMS, RCS, WHATSAPP), isTest, phoneNumber, email, lastContactType e lastCampaignType. I risultati sono paginati: page parte da 0, limit ha come valore predefinito 10 (massimo 1000). Usa sortBy per scegliere il campo di ordinamento (predefinito fullName) e sortOrder per asc o desc. Usa questo endpoint per visualizzare in anteprima il pubblico di una lista contatti prima di assegnarla a una campagna, o per verificare quali contatti sono stati importati dopo il caricamento di un file. Restituisce 404 se non esiste alcuna lista contatti con il listId specificato nel tuo account. Restituisce 500 in caso di errore imprevisto del server.

Richiesta

Risposte

200

Contatti recuperati con successo

404

Lista contatti non trovata

500

Errore interno del server