List lists
https://email.growthdept.ai/api/listsSort by created, id, name, updated, ascending or descending (put - in front).
Rate limits
Scopes
lists:read
Operation id
get_lists The same operation as in Klaviyo's API. OpenAPI document
Query parameters
Pick values to add them to the request:
Pick values to add them to the request:
Pick values to add them to the request:
Fields and the operators each one takes:
- name: equals, any
- id: equals, any
- created: greater-than
- updated: greater-than
Pick values to add them to the request:
Headers
stringrequireddefault 2026-10-15
API revision, YYYY-MM-DD. This server implements 2026-10-15.
Responses
200Success
Response body
object
dataarray of objectsrequired
data: 5 fields
typestringrequired
listidstringrequired
attributesobjectrequired
attributes: 4 fields
namestringcan be null
createdstring (date-time)can be null
updatedstring (date-time)can be null
opt_in_processstringcan be null
double_opt_insingle_opt_in
relationshipsobject
relationships: 3 fields
profilesobject
profiles: 2 fields
dataarray of objects
data: 2 fields
typestringrequired
profileidstringrequired
linksobject
links: 2 fields
selfstring (uri)required
relatedstring (uri)required
tagsobject
tags: 2 fields
dataarray of objects
data: 2 fields
typestringrequired
tagidstringrequired
linksobject
links: 2 fields
selfstring (uri)required
relatedstring (uri)required
flow-triggersobject
flow-triggers: 2 fields
dataarray of objects
data: 2 fields
typestringrequired
flowidstringrequired
linksobject
links: 2 fields
selfstring (uri)required
relatedstring (uri)required
linksobjectrequired
links: 1 field
selfstring (uri)required
linksobject
links: 3 fields
selfstring (uri)required
prevstring (uri)
nextstring (uri)
metaobject
includedarray of objects
One option: TagResponseObjectResource
typestringrequired
tagidstringrequired
attributesobjectrequired
attributes: 1 field
namestringrequired
relationshipsobject
relationships: 5 fields
tag-groupobject
tag-group: 2 fields
dataobject
data: 2 fields
typestringrequired
tag-groupidstringrequired
linksobject
links: 2 fields
selfstring (uri)required
relatedstring (uri)required
listsobject
lists: 2 fields
dataarray of objects
data: 2 fields
typestringrequired
listidstringrequired
linksobject
links: 2 fields
selfstring (uri)required
relatedstring (uri)required
segmentsobject
segments: 2 fields
dataarray of objects
data: 2 fields
typestringrequired
segmentidstringrequired
linksobject
links: 2 fields
selfstring (uri)required
relatedstring (uri)required
campaignsobject
campaigns: 2 fields
dataarray of objects
data: 2 fields
typestringrequired
campaignidstringrequired
linksobject
links: 2 fields
selfstring (uri)required
relatedstring (uri)required
flowsobject
flows: 2 fields
dataarray of objects
data: 2 fields
typestringrequired
flowidstringrequired
linksobject
links: 2 fields
selfstring (uri)required
relatedstring (uri)required
linksobjectrequired
links: 1 field
selfstring (uri)required
One option: FlowResponseObjectResource
typestringrequired
flowidstringrequired
attributesobjectrequired
attributes: 6 fields
namestringcan be null
statusstringcan be null
archivedbooleancan be null
createdstring (date-time)can be null
updatedstring (date-time)can be null
trigger_typestringcan be null
Added to ListDate BasedLow InventoryMetricPrice DropUnconfigured
relationshipsobject
relationships: 2 fields
flow-actionsobject
flow-actions: 2 fields
dataarray of objects
data: 2 fields
typestringrequired
flow-actionidstringrequired
linksobject
links: 2 fields
selfstring (uri)required
relatedstring (uri)required
tagsobject
tags: 2 fields
dataarray of objects
data: 2 fields
typestringrequired
tagidstringrequired
linksobject
links: 2 fields
selfstring (uri)required
relatedstring (uri)required
linksobjectrequired
links: 1 field
selfstring (uri)required
4XXClient error
Response body
object
errorsarray of objectsrequired
errors: 8 fields
idstringrequired
statusintegerrequired
codestringrequired
titlestringrequired
detailstringrequired
sourceobject
source: 2 fields
pointerstring
parameterstring
linksobject
metaobject
See status codes for each code.
5XXServer error
Response body
object
errorsarray of objectsrequired
errors: 8 fields
idstringrequired
statusintegerrequired
codestringrequired
titlestringrequired
detailstringrequired
sourceobject
source: 2 fields
pointerstring
parameterstring
linksobject
metaobject