List Folder Contents

curl --request GET \
  --url https://go.aiinsurance.io/api/v1/companies/{companyId}/folders/{folderId} \
  --header 'Authorization: <api-key>'

import requests

url = "https://go.aiinsurance.io/api/v1/companies/{companyId}/folders/{folderId}"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://go.aiinsurance.io/api/v1/companies/{companyId}/folders/{folderId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://go.aiinsurance.io/api/v1/companies/{companyId}/folders/{folderId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://go.aiinsurance.io/api/v1/companies/{companyId}/folders/{folderId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://go.aiinsurance.io/api/v1/companies/{companyId}/folders/{folderId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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
}

GET

api

companies

{companyId}

folders

{folderId}

List Folder Contents

curl --request GET \
  --url https://go.aiinsurance.io/api/v1/companies/{companyId}/folders/{folderId} \
  --header 'Authorization: <api-key>'

import requests

url = "https://go.aiinsurance.io/api/v1/companies/{companyId}/folders/{folderId}"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://go.aiinsurance.io/api/v1/companies/{companyId}/folders/{folderId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://go.aiinsurance.io/api/v1/companies/{companyId}/folders/{folderId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://go.aiinsurance.io/api/v1/companies/{companyId}/folders/{folderId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://go.aiinsurance.io/api/v1/companies/{companyId}/folders/{folderId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

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

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.

Show child attributes

folders

object[]

The folder's direct subfolders

Show child attributes

files

object[]

The files placed directly in the folder (paginated)

Show child attributes

totalCount

integer

Total number of files in the folder across all pages

⌘I

Getting Started

User

Entities

Event Lifecycle

Policy Transactions

Financials

Rating

Notes

Tasks

Configuration Management

Company Files

Forms

Document Generation

Submission Parsing

Reference

List Folder Contents

Authorizations

Path Parameters

Query Parameters

Response