Skip to main content
GET
/
api
/
v1
/
external
/
companies
/
{companyId}
/
folders
Get Folder Tree
curl --request GET \
  --url https://app.aiinsurance.io/api/v1/external/companies/{companyId}/folders \
  --header 'Authorization: <api-key>'
{
  "folders": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "parentFolderId": null,
      "name": "Claims Documents"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440002",
      "parentFolderId": "550e8400-e29b-41d4-a716-446655440001",
      "name": "2026 Q1"
    }
  ]
}

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).

Response

The owner's folder tree

​
folders
object[]