Skip to main content
GET
Get recently added contacts from a list

Parámetros de ruta

list_id
integer
requerido

Unique identifier for the list you're looking for.

Parámetros de consulta

count
integer
predeterminado:20

This parameter lets you specify the amount of contacts to return in your API call. The default is 20 contacts. The maximum is 100.

Rango requerido: x <= 100
timeOffset
integer

Used in conjunction with the vidOffset parameter to page through the recent contacts. Every call to this endpoint will return a time-offset value.

vidOffset
integer

Used in conjunction with the timeOffset parameter to page through the recent contacts. Every call to this endpoint will return a vid-offset value.

property
string[]

If you include the "property" parameter, then the properties in the "contact" object in the returned data will only include the property or properties that you request.

propertyMode
enum<string>
predeterminado:value_only

One of "value_only" or "value_and_history" to specify if the current value for a property should be fetched, or the value and all the historical values for that property.

Opciones disponibles:
value_only,
value_and_history
formSubmissionMode
enum<string>
predeterminado:newest

One of "all", "none", "newest", "oldest" to specify which form submissions should be fetched.

Opciones disponibles:
all,
none,
newest,
oldest
showListMemberships
boolean
predeterminado:false

Boolean to indicate whether current list memberships should be fetched for the contact.

Respuesta

200 - application/json

Successful response with recently added contacts

contacts
object[]
has-more
boolean
vid-offset
integer
time-offset
integer
Última modificación el 3 de abril de 2026