Kontakte: Listen
Mitglieder auflisten
Durchlaufen Sie die Mitglieder einer Liste in E-Mail-Reihenfolge, optional nur die anschreibbaren. Der schnellste Weg, eine ganze Liste zu exportieren oder anzuschreiben.
https://g.sendcorex.com/v1/contactscommand: list_membersErfordert den Scope contact:read auf Ihrem API Key.
Argumente
list_idstringerforderlichDie Liste.
z. B.
"customers"sendable_onlybooleanoptionalNur Mitglieder, die für die Liste angemeldet sind und Status
subscribedhaben. Wird auf dem Server gefiltert.hydratebooleanoptionalFügt jedem Mitglied den vollständigen Kontakt hinzu. Senkt das maximale
limitauf 1000.limitnumberoptionalSeitengröße, von 1 bis 5000 (1000 mit
hydrate). Standard: 100.cursorstringoptionalDer
next_cursorder vorherigen Seite.selectstring[]optionalMit
hydratenur diese Teile jedes Kontakts zurückgeben, zum Beispiel["first_name", "fields.plan"].emailkommt immer zurück.
Schnellstart
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/contacts',
{
commands: [
{
command: "list_members",
args: {
list_id: "customers",
sendable_only: true,
limit: 1000
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } },
);
const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);Antwort
{
"type": "SUCCESS",
"results": [
{
"command": "list_members",
"id": "0",
"type": "SUCCESS",
"took_ms": 14,
"data": {
"members": [
{
"email": "ana@acme.com",
"sendable": true,
"subscribed": true,
"added_at": "2026-10-13T06:05:08.323Z"
},
{
"email": "bob@gmail.com",
"sendable": true,
"subscribed": true,
"added_at": "2026-10-13T06:05:08.323Z"
}
],
"has_more": true,
"next_cursor": "eyJsIjoiY3VzdG9tZXJzIn0"
}
}
]
}Antwortfelder
members[].emailDie E-Mail des Mitglieds.
members[].subscribedFür diese Liste angemeldet.
members[].sendableFür diese Liste angemeldet und mit Status
subscribed.members[].added_atWann der Kontakt der Liste beigetreten ist.
members[].contactDer Kontakt. Nur mit
hydrate.has_more / next_cursorPaginierung. Senden Sie
next_cursoralscursor, um die nächste Seite zu erhalten.
Mit dem vollständigen Kontakt
Mit hydrate: true bringt jedes Mitglied auch contact mit. Fügen Sie select hinzu, um den Payload klein zu halten, zum Beispiel nur den Namen und ein Feld, das Sie in der E-Mail verwenden.
Ein hydratisiertes Mitglied
{
"email": "ana@acme.com",
"sendable": true,
"subscribed": true,
"added_at": "2026-10-13T06:05:08.323Z",
"contact": {
"email": "ana@acme.com",
"first_name": "Ana",
"fields": {
"plan": "pro"
}
}
}List Members oder Query Contacts?
List Members liest eine Liste in E-Mail-Reihenfolge, so schnell es geht. Wenn Sie zusätzlich nach Tag, Feld oder Engagement filtern, verwenden Sie Query Contacts mit list im where.
Fehler
Fehler auf HTTP-Ebene liefern type, code und message. Mit CMD markierte Fehler kommen im Befehlsergebnis zurück, mit HTTP 200.
- 401
INVALID_API_KEYDer API Key existiert nicht, wurde widerrufen oder im Dashboard deaktiviert.
- 429
RATE_LIMITEDMehr als 15 Requests/s oder 15 gleichzeitig für dieselbe IP + API Key. Warten Sie die Sekunden aus Retry-After ab.
- CMD
MISSING_SCOPEDem API Key fehlt der Scope, den dieser Befehl braucht. Die anderen Befehle im Request laufen trotzdem.
- CMD
INVALID_ARGSEin Pflichtargument fehlt oder ist ungültig: E-Mail, Feldwert, Enum-Option, where-Schlüssel, Listen-ID …
- CMD
NOT_FOUNDDer Kontakt, die Liste, das Feld oder das Segment existiert nicht.
- CMD
INVALID_CURSORDer Cursor ist fehlerhaft oder gehört zu einer anderen Abfrage oder einem anderen Konto.
- CMD
INTERNALServerfehler. Details werden nur ins Server-Log geschrieben.