Listar contactos
GET/v1/contacts
Scope necesario: read o full. Una clave full incluye send y read.
subscribed, unsubscribed, bounced, complained, blocked). Filtros q, status, listId y tag; paginación por cursor. Solo lectura: no hay escrituras de contactos en la API.
Parámetros
| Campo | Descripción |
|---|---|
cursorstring · query | nextCursor de la página anterior con los mismos filtros. |
limitnumber · query | |
qstring · query | |
statusstring · query | |
listIdstring · query | |
tagstring · query |
Respuestas
200Campo Descripción data[]object[] · obligatoriodata[].idstring · obligatoriodata[].objectstring · obligatoriovalores: contact data[].emailstring · obligatorioej.: [email protected] data[].firstNamestring | null · obligatoriodata[].lastNamestring | null · obligatoriodata[].statusstring · obligatoriovalores: subscribed | unsubscribed | bounced | complained | blocked data[].tagsstring[] · obligatoriodata[].sourceobject · obligatoriodata[].source.kindstring · obligatoriovalores: manual | import | form | api | unknown data[].source.labelstring · obligatorioej.: Importación data[].createdAtstring · obligatoriodata[].lists[]object[] · obligatoriodata[].lists[].idstring · obligatoriodata[].lists[].namestring · obligatorionextCursorstring | null · obligatorio
Ejemplo
curl "https://api.vemudo.com/v1/contacts?status=subscribed&limit=50" -H "Authorization: Bearer $VEMUDO_API_KEY"