> ## Documentation Index
> Fetch the complete documentation index at: https://learn.nexudus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Files

> Returns the authenticated customer's files and documents.

# List Files

Returns the list of files and documents associated with the authenticated customer's account, including contracts, agreements, and uploaded documents.

## Authentication

Requires a valid customer bearer token.

## Query Parameters

**\_shape** `string`

Comma-separated list of field paths to include in the response. When provided, only the
specified fields are returned — useful for reducing payload size. Supports nested paths
using dot notation.

## Response

Returns an array of file objects with the following fields.

### File Fields

#### Identity

| Field | Type | Description |
| - | - | - |
| `Id` | `number` | Unique numeric identifier for the file |
| `UniqueId` | `string` | Globally unique identifier |

#### Core

| Field | Type | Description |
| - | - | - |
| `Name` | `string` | File display name |
| `Description` | `string` | File description |
| `BusinessName` | `string` | Location that owns the file |
| `Signed` | `boolean` | Whether the document has been signed |
| `RequestDigitalSignature` | `boolean` | Whether a digital signature is required |
| `ProposalUniqueId` | `string \| null` | Linked proposal GUID (if applicable) |

#### Timestamps (from base)

| Field | Type | Description |
| - | - | - |
| `CreatedOn` | `string` | Date created (business-local time) |
| `UpdatedOn` | `string \| null` | Date last updated (business-local time) |
| `CreatedOnUtc` | `string` | Date created (UTC) |
| `UpdatedOnUtc` | `string \| null` | Date last updated (UTC) |

## Examples

### Fetch my files

```http theme={null}
GET /api/public/files/my
Authorization: Bearer {token}
```

## TypeScript Integration

```typescript theme={null}
import endpoints from '@/api/endpoints'

const response = await httpClient.get(endpoints.files.list)
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.