Skip to main content
GET
/
api
/
public
/
files
/
my

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

FieldTypeDescription
IdnumberUnique numeric identifier for the file
UniqueIdstringGlobally unique identifier

Core

FieldTypeDescription
NamestringFile display name
DescriptionstringFile description
BusinessNamestringLocation that owns the file
SignedbooleanWhether the document has been signed
RequestDigitalSignaturebooleanWhether a digital signature is required
ProposalUniqueIdstring | nullLinked proposal GUID (if applicable)

Timestamps (from base)

FieldTypeDescription
CreatedOnstringDate created (business-local time)
UpdatedOnstring | nullDate last updated (business-local time)
CreatedOnUtcstringDate created (UTC)
UpdatedOnUtcstring | nullDate last updated (UTC)

Examples

Fetch my files

GET /api/public/files/my
Authorization: Bearer {token}

TypeScript Integration

import endpoints from '@/api/endpoints'

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