Skip to main content
GET
/
api
/
v1
/
external
/
companies
/
{companyId}
/
files
List Files
curl --request GET \
  --url https://app.aiinsurance.io/api/v1/external/companies/{companyId}/files \
  --header 'Authorization: <api-key>'
{
  "items": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440020",
      "entityType": "company",
      "entityId": null,
      "placementId": "550e8400-e29b-41d4-a716-446655440030",
      "placementCount": 1,
      "displayName": "master-agreement.pdf",
      "contentType": "application/pdf",
      "byteSize": 482133,
      "uploadedAt": "2026-06-10T09:15:00.000Z",
      "uploadedBy": "550e8400-e29b-41d4-a716-446655440099",
      "uploadedByName": "Jane Underwriter",
      "folderId": null,
      "category": null
    }
  ],
  "totalCount": 1
}

Authorizations

​
Authorization
string
header
required

API key authentication. Send your raw API key as the Authorization header value with NO scheme prefix — Authorization: YOUR-API-KEY. Do NOT prefix it with Bearer or ApiKey, and do not use an X-API-Key header; those are not accepted.

Path Parameters

​
companyId
string<uuid>
required

Company identifier

Query Parameters

​
entityType
enum<string>
required

The file owner's entity type — a configured Field Model V1 entity type (PascalCase), or company for company-level files and folders.

Available options:
Event,
Exposure,
Quote,
Submission,
Person,
Organization,
Policy,
company
​
entityId
string<uuid>

The owner entity's id. Required for every entityType except company (company-level files and folders have no entity id — omit this parameter).

​
folderId
string

Folder placement filter — omit for every folder, a folder id for that folder, or empty (folderId=) for the owner's top level.

​
page
integer
default:1

Page number (1-based, default 1, page size 50)

Required range: x >= 1
​
pageSize
integer
default:50

Number of records per page (default 50).

Required range: x >= 1

Response

Paginated list of files

​
items
object[]
​
totalCount
integer

Total number of matching files across all pages