List the current user's data views
Returns a paginated list of data views (saved filters) belonging to the authenticated user, optionally scoped to a project, data type, or updated-since timestamp.
Query Params
- Name
projectId- Type
- integer
- Description
Restrict results to data views belonging to this project.
- Default
-1
- Name
title- Type
- string
- Description
Filter data views by exact title match (SQL equality, not a partial/substring match).
- Name
useCaching- Type
- boolean
- Description
Whether to use the server-side response cache (ETag caching).
- Default
true
- Name
showDeleted- Type
- boolean
- Description
Include soft-deleted data views in the results.
- Default
false
- Name
getEmoji- Type
- boolean
- Description
Parse emoji shortcodes in title/description to unicode.
- Default
true
- Name
includeTemporary- Type
- boolean
- Description
Include temporary (unsaved/draft) data views.
- Default
false
- Name
page- Type
- integer
- Description
Page number to return.
- Default
1
- Name
pageSize- Type
- integer
- Description
Number of records per page.
- Default
50
- Name
dataType- Type
- string
- Description
Restrict results to data views of this type (e.g. tasks, projects, milestones). Pass "ALL" to return every type, or a comma-separated list of types.
- Default
ALL
- Name
getShareData- Type
- boolean
- Description
Include sharedWith (users/companies/teams) information for each data view. This also changes which records are returned: when true, the result set additionally includes data views that other users have shared with you (via user, company, or team shares), not just your own views.
- Default
false
- Name
updatedAfterDate- Type
- string
- Description
Only return data views updated after this timestamp. Must be in YYYYMMDDHHMMSS format.
- Name
dataViewId- Type
- integer
- Description
Return only the data view(s) with this ID. Accepts a comma-separated list of IDs. When set to a value other than 0, this replaces userId, projectId, dataType, title, isTemporary and includeTemporary as the record filter (those parameters are ignored); showDeleted and isDefault still apply.
- Default
0
- Name
fulldata- Type
- boolean
- Description
Accepted by the endpoint but currently has no effect on the request or response.
- Default
false
- Name
sortBy- Type
- string
- Description
Field to sort results by. Any other value is treated the same as "name".
- Default
name- Allowed values
namedateUpdated
- Name
sortOrder- Type
- string
- Description
Sort direction. The endpoint accepts any value; anything other than "asc" or "desc" (case-insensitive) is silently treated as "desc".
- Default
asc
- Name
userId- Type
- integer
- Description
Return data views belonging to this user (defaults to the current session user).
- Name
isDefault- Type
- boolean
- Description
Only return data views marked as the user's default/selected view.
- Default
false
- Name
isTemporary- Type
- boolean
- Description
Only return temporary data views.
- Default
false
Headers
- Name
If-None-Match- Type
- string
- Description
ETag from a previous response. If it matches the current server-side ETag, the endpoint returns 304 with no body. Only honoured when useCaching is true.
Responses
- Code
- 200
- Type
- object
- Schema
- Description
- A List Of Data Views
- Code
- 304
- Description
- Not Modified Returned Instead Of 200 When Use Caching Is True And The If None Match Header Matches The Current E Tag The Body Is Empty
- Code
- 400
- Type
- object
- Schema
- Description
- Invalid Parameters
A list of data views.
{
"STATUS": "OK",
"dataViews": [
{
"id": "12345",
"title": "string",
"description": "string",
"isTemporary": true,
"isDefault": true,
"isProjectSpecific": true,
"userId": "string",
"projectId": "string",
"dataType": "tasks",
"displayMode": "string",
"sortBy": "string",
"sortOrder": "string",
"deleted": true,
"dateCreated": "2026-08-10T21:24:46.329Z",
"dateUpdated": "2026-08-10T21:24:46.329Z",
"dateDeleted": "string",
"displaySettings": {},
"canEdit": true,
"sharedWith": {
"users": "string",
"companies": "string",
"teams": "string"
}
}
]
}