# List documents for an entity

Endpoint: GET /v1alpha/entities/{entity}/documents
Version: v1alpha
Security: oauth2_client_credentials, oauth2_authorization_code

## Path parameters:

  - `entity` (string, required)
    The entity id.

## Query parameters:

  - `pageSize` (integer)
    Optional. The maximum number of entities to return. The service may return fewer than
 this value.
 If unspecified, at most 50 entities will be returned.
 The maximum value is 1000; values above 1000 will be coerced to 1000.

  - `pageToken` (string)
    Optional. A page token, received from a previous ListEntities call.
 Provide this to retrieve the subsequent page.
 When paginating, all other parameters provided to ListEntities must
 match the call that provided the page token.

  - `showDeleted` (boolean)
    Optional. If true, soft-deleted entities will be included in the response.
 See AIP-164.

  - `skip` (integer)
    Optional. The number of entities to skip before starting to collect the result set.

  - `filter` (string)
    Optional. A filter expression that filters the results listed in the response.
 Filter only currently supports a fuzzy search on display name.
 See AIP-160 for more details.

  - `orderBy` (string)
    (OPTIONAL) string.example = ["displayName desc"]

## Response 200 fields (application/json):

  - `documents` (array)
    The list of documents.

  - `documents.name` (string)
    (IDENTIFIER) The resource name of the document.
 Format: documents/{document}

  - `documents.displayName` (string, required)
    Optional. A mutable, user-settable field for providing a human-readable
 name for the document, to be used in user interfaces. Must be <= 63
 characters.
string.example = ["John Doe - Driver's License"]
string.max_len = 128
string.min_len = 1

  - `documents.content` (string, required)
    The content of the document. Maximum file size is 10Mib.
bytes.max_len = 10485760
bytes.min_len = 1

  - `documents.createTime` (string)
    Output only. The timestamp when the document was created.

  - `documents.updateTime` (string)
    Output only. The timestamp when the document was most recently updated.

  - `nextPageToken` (string)
    A token to retrieve the next page of results.

  - `totalSize` (integer)
    The total number of documents.