Retrieve a list of contact filters
get
/api/bulk/2.0/contacts/filters
Retrieves a list of contact filters that match the criteria specified in the URL parameters.
Request
Supported Media Types
- application/json
- text/csv
Query Parameters
Back to Top
Response
Supported Media Types
- application/json
200 Response
OK.
Root Schema : ContactFilterSearchResponse
Type:
object
Title:
Show Source
ContactFilterSearchResponse
-
count:
integer
Title:
count
-
hasMore:
boolean
Title:
hasMore
-
items:
array items
Title:
items
-
limit:
integer
Title:
limit
-
offset:
integer
Title:
offset
-
totalResults:
integer(int64)
Title:
totalResults
Nested Schema : items
Type:
array
Title:
Show Source
items
-
Array of:
object ContactFilter
Title:
ContactFilter
Nested Schema : ContactFilter
Type:
object
Title:
Show Source
ContactFilter
-
count:
integer
Title:
count
-
createdAt:
string(date-time)
Title:
createdAt
-
createdBy:
string
Title:
createdBy
-
executedAt:
string(date-time)
Title:
executedAt
-
name:
string
Title:
name
-
statement:
string
Title:
statement
-
updatedAt:
string(date-time)
Title:
updatedAt
-
updatedBy:
string
Title:
updatedBy
-
uri:
string
Title:
uri
400 Response
Bad request. See Status Codes for information about other possible HTTP status codes.
401 Response
Unauthorized. See Status Codes for information about other possible HTTP status codes.
403 Response
Forbidden. See Status Codes for information about other possible HTTP status codes.
404 Response
The requested resource was not found. See Status Codes for information about other possible HTTP status codes.
409 Response
There was a conflict. See Status Codes for information about other possible HTTP status codes.
410 Response
The requested resource is no longer available. See Status Codes for information about other possible HTTP status codes.
412 Response
The resource you are attempting to delete has dependencies, and cannot be deleted. See Status Codes for information about other possible HTTP status codes.
413 Response
Storage space exceeded. See Status Codes for information about other possible HTTP status codes.
500 Response
The service has encountered an internal server error. See Status Codes for information about other possible HTTP status codes.
503 Response
There was a timeout processing the request. See Status Codes for information about other possible HTTP status codes.
Examples
Retrieve a list of the contact filters with "Touch" somewhere in the name field:
GET /contacts/filters?q="name=*Touch*"
Response:
{
"items":[
{
"name":"Lead Score - Last High Touch Event - Last 180 Days",
"count":0,
"statement":"{{ContactFilter[100050]}}",
"uri":"/contacts/filters/100050",
"createdBy":"Deploy.User",
"createdAt":"2010-02-24T18:40:36.1230000Z",
"updatedBy":"Deploy.User",
"updatedAt":"2010-02-24T18:40:36.1230000Z"
},
{
"name":"Lead Score - Last High Touch Event - Last 30 Days",
"count":0,
"statement":"{{ContactFilter[100051]}}",
"uri":"/contacts/filters/100051",
"createdBy":"Deploy.User",
"createdAt":"2010-02-24T18:41:07.0200000Z",
"updatedBy":"Deploy.User",
"updatedAt":"2010-02-24T18:41:07.0200000Z"
},
{
"name":"Lead Score - Last High Touch Event - Last 60 Days",
"count":0,
"statement":"{{ContactFilter[100052]}}",
"uri":"/contacts/filters/100052",
"createdBy":"Deploy.User",
"createdAt":"2010-02-24T18:41:30.9070000Z",
"updatedBy":"Deploy.User",
"updatedAt":"2010-12-22T00:21:40.3970000Z"
}
],
"totalResults":3,
"limit":1000,
"offset":0,
"count":3,
"hasMore":false
}