Get documents in the workspace accessible to the calling user | Docusign

{
  "documents": [
    {
      "document_id": "9e2f4a8b-3c7d-4e5f-a1b2-8c9d6e3f4a7b",
      "name": "Contract Agreement.pdf",
      "owner_id": "211e2d22-f070-4c8d-b6a7-ecb14ceb81b4",
      "size": 245760,
      "created_date": "2025-09-01T12:00:00Z",
      "last_updated_date": "2025-09-01T12:00:00Z",
      "owner": {
        "first_name": "John",
        "last_name": "Doe"
      }
    },
    {
      "document_id": "1f3e5b9c-4d8a-5e6f-b2c3-9d0e7f4a8b1c",
      "name": "Employee Handbook.docx",
      "owner_id": "211e2d22-f070-4c8d-b6a7-ecb14ceb81b4",
      "size": 512000,
      "created_date": "2025-09-01T12:00:00Z",
      "last_updated_date": "2025-09-01T13:00:00Z",
      "owner": {
        "first_name": "John",
        "last_name": "Doe"
      }
    }
  ],
  "result_set_size": 2,
  "start_position": 0,
  "end_position": 1,
  "total_row_count": 2
}

This operation retrieves the documents in the workspace that are accessible to the calling user. Documents may be added directly or automatically through tasks such as envelopes. Documents may be used to create envelopes.

Pagination is supported by passing start_position and count in the request. The response will include resultSetSize, start_position, and end_position which may be utilized for subsequent requests.

Required authentication scopes: dtr.rooms.read

Authentication

AuthorizationBearer

JWT Bearer token from Docusign authorization server

Path parameters

accountIdstringRequiredformat: "uuid"

The ID of the account

workspaceIdstringRequiredformat: "uuid"

The ID of the workspace

Query parameters

countintegerOptional

Number of documents to return. Defaults to the maximum which is 100

start_positionintegerOptional

Position of the first item in the total results. Defaults to 0

name_filterstringOptional

Filter documents where Name contains the filter. Defaults to null, to not filter

Response

Documents successfully retrieved

documentslist of objects or nullOptional

The document summary list. Includes the ID, name, and metadata

result_set_sizeinteger or nullOptional

The number of documents returned in the response. Always equal or less than the count of the request

start_positioninteger or nullOptional

Position of the first item in the total results

end_positioninteger or nullOptional

Position of the last item in the total results

total_row_countinteger or nullOptional

The total number of documents in the workspace applicable to the request regardless of pagination. It may not always be computed

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error