List Surveys (POST)
List surveys requested by the user.
All the DevRev APIs require a token to authenticate the user. Provide Authorization: Bearer <TOKEN> as a header to every API request.
How do I find my token?
In: header
Filters for surveys created by any of these users.
Provides ways to specify date ranges on objects.
Filters for objects created after the provided timestamp (inclusive).
date-timeFilters for objects created before the provided timestamp (inclusive).
date-timeProvides preset types for date filter.
The range starts from the current timestamp and continues for the past n days.
0 <= value <= 4294967295The range starts from the current timestamp and continues for the next n days.
0 <= value <= 4294967295The cursor to resume iteration from. If not provided, then iteration starts from the beginning.
textThe maximum number of surveys to return. If not set, then the default is '50'.
int32The iteration mode to use. If "after", then entries after the provided cursor will be returned, or if no cursor is provided, then from the beginning. If "before", then entries before the provided cursor will be returned, or if no cursor is provided, then from the end. Entries will always be returned in the specified sort-by order.
"after" | "before"Provides ways to specify date ranges on objects.
Filters for objects created after the provided timestamp (inclusive).
date-timeFilters for objects created before the provided timestamp (inclusive).
date-timeProvides preset types for date filter.
The range starts from the current timestamp and continues for the past n days.
0 <= value <= 4294967295The range starts from the current timestamp and continues for the next n days.
0 <= value <= 4294967295Filters for surveys by name(s).
Fields to sort the surveys by and the direction to sort them.
Response Body
curl -X POST "https://api.devrev.ai/surveys.list" \ -H "Content-Type: application/json" \ -d '{}'{
"next_cursor": "string",
"prev_cursor": "string",
"surveys": [
{
"created_by": {
"type": "dev_user",
"display_id": "string",
"id": "string",
"display_name": "string",
"display_picture": {
"display_id": "string",
"id": "string",
"file": {
"type": "string",
"name": "string",
"size": 0
}
},
"email": "string",
"full_name": "string",
"state": "active"
},
"created_date": "2023-01-01T12:00:00.000Z",
"display_id": "string",
"id": "string",
"modified_by": {
"type": "dev_user",
"display_id": "string",
"id": "string",
"display_name": "string",
"display_picture": {
"display_id": "string",
"id": "string",
"file": {
"type": "string",
"name": "string",
"size": 0
}
},
"email": "string",
"full_name": "string",
"state": "active"
},
"modified_date": "2023-01-01T12:00:00.000Z",
"description": "string",
"header": "string",
"introductory_text": "string",
"name": "string",
"response_text": "string",
"schema": [
{
"field_type": "array",
"description": "string",
"is_filterable": true,
"is_immutable": true,
"is_pii": true,
"is_required": true,
"mfz": {},
"name": "string",
"oasis": {},
"origin": "string",
"ui": {
"client_overrides": [
{
"client_name": "string",
"decimal_places": 0,
"display_name": "string",
"is_groupable": true,
"is_hidden": true,
"order": 0,
"placeholder": "string",
"tooltip": "string",
"use_shorthand_notation": true,
"view_overrides": [
{
"decimal_places": 0,
"display_name": "string",
"is_groupable": true,
"is_hidden": true,
"order": 0,
"placeholder": "string",
"tooltip": "string",
"use_shorthand_notation": true,
"view_name": "string"
}
]
}
],
"decimal_places": 0,
"display_name": "string",
"group_name": "string",
"is_groupable": true,
"is_hidden": true,
"is_sortable": true,
"order": 0,
"placeholder": "string",
"tooltip": "string",
"unit": "string",
"use_shorthand_notation": true
},
"default_value": true
}
],
"schema_with_metadata": [
{
"field": {
"field_type": "array",
"description": "string",
"is_filterable": true,
"is_immutable": true,
"is_pii": true,
"is_required": true,
"mfz": {},
"name": "string",
"oasis": {},
"origin": "string",
"ui": {
"client_overrides": [
{
"client_name": "string",
"decimal_places": 0,
"display_name": "string",
"is_groupable": true,
"is_hidden": true,
"order": 0,
"placeholder": "string",
"tooltip": "string",
"use_shorthand_notation": true,
"view_overrides": [
{
"decimal_places": 0,
"display_name": "string",
"is_groupable": true,
"is_hidden": true,
"order": 0,
"placeholder": "string",
"tooltip": "string",
"use_shorthand_notation": true,
"view_name": "string"
}
]
}
],
"decimal_places": 0,
"display_name": "string",
"group_name": "string",
"is_groupable": true,
"is_hidden": true,
"is_sortable": true,
"order": 0,
"placeholder": "string",
"tooltip": "string",
"unit": "string",
"use_shorthand_notation": true
},
"default_value": true
},
"metadata": {},
"question": "string"
}
],
"title": "string"
}
]
}{
"detail": "string",
"message": "string",
"type": "artifact_already_attached_to_a_parent",
"existing_parent": "string",
"is_same": true
}{
"detail": "string",
"message": "string",
"type": "unauthenticated"
}{
"detail": "string",
"message": "string",
"type": "forbidden"
}{
"detail": "string",
"message": "string",
"type": "too_many_requests",
"retry_after": 0
}{
"detail": "string",
"message": "string",
"type": "internal_error",
"reference_id": "string"
}{
"detail": "string",
"message": "string",
"type": "service_unavailable"
}