List documents on request | Docusign

{
  "_links": {
    "self": {
      "href": "https://api.docusign.com/v1/accounts/9f8e7d6c-1234-4a5b-8c9d-0e1f2a3b4c5d/requests/3f7c9e4b-851c-4f9b-89e7-123456789abc/documents"
    }
  },
  "response_metadata": {
    "request_id": "3f7c9e4b-851c-4f9b-89e7-123456789abc",
    "response_timestamp": "2026-08-26T14:30:00Z",
    "page_limit": 25
  },
  "documents": [
    {
      "_links": {
        "document": {
          "href": "https://api.docusign.com/dms/v1/documents/5d4c3b2a-1f0e-4d3c-9b8a-7f6e5d4c3b2a/download"
        }
      },
      "metadata": {
        "created_at": "2026-08-26T14:25:00Z",
        "created_by": "bbbb2222-cccc-4ddd-8eee-ffff33334444",
        "modified_at": "2026-08-26T14:25:00Z",
        "modified_by": "bbbb2222-cccc-4ddd-8eee-ffff33334444"
      },
      "id": "5d4c3b2a-1f0e-4d3c-9b8a-7f6e5d4c3b2a",
      "name": "NDA-Draft-v1.pdf",
      "content_type": "application/pdf",
      "current_version": 1,
      "label": {
        "id": "66666666-6666-4666-8666-666666666666",
        "name": "Draft"
      },
      "_actions": {}
    }
  ]
}

Returns the list of documents attached to the specified request.

Authentication

AuthorizationBearer

Docusign OAuth 2.0 access token

Path parameters

accountIdstringRequiredformat: "uuid"

The ID of the account that owns the request statuses.

requestIdstringRequiredformat: "uuid"

The ID of the request (Agreement Desk ticket) the document belongs to.

Response

The list of documents on the request.

_linksobjectOptional

Hypermedia controls (HATEOAS) for navigating between pages in a paginated collection of results. Links for the current page, next page, and previous page.

response_metadataobjectOptional

Control information and metadata for the response.

documentslist of objectsOptional

The documents attached to the request.

Errors

401

Unauthorized Error

404

Not Found Error