---
title: "Document Activity Entries REST API endpoints"
canonical: "https://support.appfire.com/space/CDML/654246740/Document%20Activity%20Entries%20REST%20API%20endpoints"
format: markdown
---
> Macro (aura-html)


> Macro (excerpt)
> 
> [DATA CENTER] [Document Activity REST API] 
> 
> # Overview
> 
> ## Endpoints
> 
> The Document Activity REST API can retrieve workflow document activity entries from the following endpoints
> 
> ### Pages
> 
> This endpoint retrieves the document activity entries for a given list of page ids
> 
> - `http://<confluencehostname>/rest/cw/2/documentactivity/pages`
> 
> ### Spaces
> 
> This endpoint retrieves the document activity entries for a given list of space keys
> 
> - `http://<confluencehostname>/rest/cw/2/documentactivity/spaces`
> 
> ## Filtering
> 
> The requests can include filters to retrieve workflow actions that match any or all of the filters. These are some of the filters available:
> 
> - `actors` to filter by one or more users (by **userid**) who undertook an action in a document
> - `participants` to filter by one or more users (by **userid**) who were assigned to an action
> - `statenames` of the workflow states in which the actions took place
> - `fromdate` indicates that the actions must have taken place after it
> - `todate` indicates that the actions must have taken place before it
> - `types` to filter by specific types (e.g. "state", "approval") or subtypes (e.g. "expired", “approvalAssigned“) of actions
> 
> ## Pagination
> 
> A query can be separated into multiple requests providing a `limit` and an `offset` in order to retrieve all the results in different "pages"
> 
> > ℹ️ By default, each request is limited to 100 items.
> 
> ## Permissions
> 
> Depending on which of the two endpoints is used, the following user permissions are required:
> 
> - `documentactivity/pages`: [Workflow Visibility](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649956239/Configuration+-+space+tools#Workflow-Activity-and-Drafts-Visibility) over all the provided pages
> - `documentactivity/spaces`: Confluence Space Administrator permission over all the provided spaces
> 
> > 📝 If the request contains a space/page over which the user making the request does not have enough permissions then the response will be a bad request with details about the spaces/pages over which the user does not have enough permissions.
> 
> ## Document activity REST API documentation
> 
> The document activity REST API is provided as **Open API (Swagger) Documentation**.

> Macro (open-api)