Skip to main content
GET
/
api
/
v1
/
external
/
companies
/
{companyId}
/
folders
/
{folderId}
List Folder Contents
curl --request GET \
  --url https://app.aiinsurance.io/api/v1/external/companies/{companyId}/folders/{folderId} \
  --header 'Authorization: <api-key>'
{ "folder": { "id": "550e8400-e29b-41d4-a716-446655440001", "parentFolderId": null, "name": "Claims Documents" }, "folders": [ { "id": "550e8400-e29b-41d4-a716-446655440002", "parentFolderId": "550e8400-e29b-41d4-a716-446655440001", "name": "2026 Q1" } ], "files": [ { "id": "550e8400-e29b-41d4-a716-446655440020", "entityType": "company", "entityId": null, "displayName": "claim-report.pdf", "contentType": "application/pdf", "byteSize": 102400, "uploadedAt": "2026-06-10T09:15:00.000Z", "uploadedBy": "550e8400-e29b-41d4-a716-446655440099", "uploadedByName": "Jane Underwriter", "folderId": "550e8400-e29b-41d4-a716-446655440001", "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

​
folderId
string<uuid>
required

Folder identifier

Query Parameters

​
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

The folder's contents

​
folder
object

One folder node as a flat adjacency-list row — parentFolderId null means the owner's top level. The folder tree endpoint returns every live folder for an owner as these rows; consumers assemble the hierarchy client-side.

​
folders
object[]

The folder's direct subfolders

​
files
object[]

The files placed directly in the folder (paginated)

​
totalCount
integer

Total number of files in the folder across all pages