List Folder Contents

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

import requests

url = "https://app.aiinsurance.io/api/v1/external/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://app.aiinsurance.io/api/v1/external/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://app.aiinsurance.io/api/v1/external/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://app.aiinsurance.io/api/v1/external/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://app.aiinsurance.io/api/v1/external/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

{
  "items": [
    {
      "contentId": "550e8400-e29b-41d4-a716-446655440010",
      "contentType": "folder",
      "name": "Invoices",
      "mimeType": null,
      "category": null,
      "uploadedAt": null,
      "createdAt": "2026-01-20T09:00:00.000Z"
    },
    {
      "contentId": "550e8400-e29b-41d4-a716-446655440020",
      "contentType": "file",
      "name": "claim-report.pdf",
      "mimeType": "application/pdf",
      "category": "claims",
      "uploadedAt": "2026-01-20T09:15:00.000Z",
      "createdAt": "2026-01-20T09:15:00.000Z"
    }
  ],
  "totalCount": 2
}

GET

api

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>'

import requests

url = "https://app.aiinsurance.io/api/v1/external/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://app.aiinsurance.io/api/v1/external/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://app.aiinsurance.io/api/v1/external/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://app.aiinsurance.io/api/v1/external/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://app.aiinsurance.io/api/v1/external/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

{
  "items": [
    {
      "contentId": "550e8400-e29b-41d4-a716-446655440010",
      "contentType": "folder",
      "name": "Invoices",
      "mimeType": null,
      "category": null,
      "uploadedAt": null,
      "createdAt": "2026-01-20T09:00:00.000Z"
    },
    {
      "contentId": "550e8400-e29b-41d4-a716-446655440020",
      "contentType": "file",
      "name": "claim-report.pdf",
      "mimeType": "application/pdf",
      "category": "claims",
      "uploadedAt": "2026-01-20T09:15:00.000Z",
      "createdAt": "2026-01-20T09:15:00.000Z"
    }
  ],
  "totalCount": 2
}

Authorizations

Authorization

string

header

required

API key authentication. Include your API key in the Authorization header.

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

sortBy

enum<string>

default:createdAt

Field to sort by

Available options:

createdAt

sortDirection

enum<string>

default:desc

Sort direction (default desc)

Available options:

asc,

desc

Response

Paginated list of folder contents

items

object[]

Show child attributes

totalCount

integer

Total number of items across all pages

List Folder Tree Rename or Move Folder

⌘I

Getting Started

Exposures

Events

Event Financials

Policies

Submissions

Quotes

Rating

Custom Objects

Configuration Management

Basic Policies

Company Files

Document Generation

Submission Parsing

Address Tools

Reference

List Folder Contents

Authorizations

Path Parameters

Query Parameters

Response