API List Filters

This API provides a list of all current filters.

Resource URL

http://valt.example.com/api/v3/filters

Resource Information

Method	GET
Response Type	JSON
Authentication Required	Yes

Parameters

No parameters can be passed to this call.

Response

Code	Reason
200	Request Successful
401	Unauthorized

JSON Response

data
	This call returns an array of JSON objects.
	id				Filter ID
	name				Filter Name
	fields				Array of fields utilized in the filter.
		id			Field ID
		name			Field Name
		text			Filter search criteria for specified field
		field_id			? but definitely not the field ID
	rooms				Rooms included in filter.
		id			Room ID
		name			Room Name
	author				Users and Groups included in filter.
		users			User IDs
		user_groups			Group IDs
	date				Time frame for filter.
		type			Date filter type (Valid Values: none, day, weeks, range)
		days			Number of days (only included if filter type is 'day')
		weeks			Number of weeks (only included if filter type is 'weeks')
		range			Date range for filter. (only included if filter type is 'range')
			start
				date	Filter start date
				timezone_type
				timezone	Timezone for specified date range
			end
				date	Filter end date.
				timezone_type
				timezone	Timezone for specified date range

Examples

Request

https://ivstest1.ad.ipivs.com/api/v3/filters?access_token=e82632d19c523678fea3d1016c6df9e9

Successful Response

Sample response is shown with line breaks to make it more readable. Actual responses will not include line breaks.

{
    "data": [
        {
            "id": 1,
            "name": "Test Filter 1",
            "rooms": [
                {
                    "id": 1,
                    "name": "Software Talkback Room"
                },
                {
                    "id": 3,
                    "name": "2 Camera Room"
                }
            ],
            "date": {
                "type": "day",
                "days": 0
            }
        },
        {
            "id": 3,
            "name": "Recording Names with 'I/O'",
            "fields": [
                {
                    "id": 1,
                    "name": "record",
                    "text": "I/O",
                    "field_id": "record"
                }
            ],
            "date": {
                "type": "none"
            }
        },
        {
            "id": 4,
            "name": "Filter - Last 3 days",
            "date": {
                "type": "day",
                "days": -3
            }
        },
        {
            "id": 5,
            "name": "Filter - Last 2 weeks",
            "date": {
                "type": "weeks",
                "weeks": -2
            }
        },
        {
            "id": 6,
            "name": "Filter - Date Range",
            "date": {
                "type": "range",
                "range": {
                    "start": {
                        "date": "2026-06-14 00:00:00.000000",
                        "timezone_type": 3,
                        "timezone": "America/Chicago"
                    },
                    "end": {
                        "date": "2026-07-05 00:00:00.000000",
                        "timezone_type": 3,
                        "timezone": "America/Chicago"
                    }
                }
            }
        }
    ]
}

Failure Response

{"error":{"code":401,"message":"No API key provided"}}