Tasks

List data access requests

Get a paginated list of Data Access Request tasks with DAR-specific filters. Pre-applies category=DataAccess and type=DataAccessRequest. Pagination is offset-based and results are sorted by createdAt (default DESC).

get/v1/tasks/dataAccessRequests

Request

  • Base URL: https://demo.getcollate.io/api
  • URL: https://demo.getcollate.io/api/v1/tasks/dataAccessRequests
  • Auth: HTTP bearer

Query parameters

fieldsstring

Fields to include in response

statusstring

Filter by task status. Accepts a comma-separated list (e.g. 'Approved,Granted') which is matched as SQL IN(...). Allowed values match TaskEntityStatus.

statusGroup'open' | 'active' | 'closed'

Filter by status group. 'open' = Open/InProgress/Pending only (still awaiting review). 'active' = Open/InProgress/Pending/Approved/Granted (full non-terminal DAR lifecycle — use this when looking for DARs that are still 'in progress', including awaiting-grant and granted-with-active-access). 'closed' = Approved/Rejected/Completed/Cancelled/Failed/Revoked (mirrors the legacy closed bucket, which includes Approved for backward compatibility with non-DAR workflows where Approved is terminal).

datasetstring

Filter by dataset FQN (entity the DAR is about). Accepts a comma-separated list; matches each via FQN-hash prefix and OR's the results.

servicestring

Filter by parent service FQN of the dataset. Accepts a comma-separated list (OR-joined).

requestedBystring

Filter by requester FQN. Accepts a comma-separated list (OR-joined).

requestedByIdstring

Filter by requester user id. Accepts a comma-separated list of UUIDs matched via SQL IN(...).

approverstring

Filter by approver FQN. Accepts a comma-separated list (OR-joined).

approverIdstring

Filter by approver user id. Accepts a comma-separated list of UUIDs matched via SQL IN(...).

accessTypestring

Filter by access type. Accepts a comma-separated list (e.g. 'FullAccess,Masked') matched via SQL IN(...). Allowed values match DataAccessType.

assigneestring

Filter by assignee FQN (user or team). Accepts a comma-separated list (OR-joined).

assigneeIdstring uuid

Filter by assignee user/team id (single UUID).

domainstring

Filter by domain FQN

qstring

Free-text search. Database-only (DARs are not indexed into Elasticsearch). Matches case-insensitive against task name, displayName, payload.reason, about.displayName, and about.fullyQualifiedName.

sortOrder'asc' | 'desc'

Sort order on createdAt

limitinteger

Limit the number of results

offsetinteger

Offset into the result set

include'all' | 'deleted' | 'non-deleted'

Include deleted tasks

Response

List of Data Access Requests

warningsCountinteger

Changes

No recorded changes to this operation across all 1 revision of this API.