List documents
curl --request GET \
--url https://public.api.live.turrisfi.com/v2/downstream/documents \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://public.api.live.turrisfi.com/v2/downstream/documents', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://public.api.live.turrisfi.com/v2/downstream/documents"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"items": [
{
"fileDocumentId": "66a1b2c3d4e5f6a7b8c9d0e3",
"name": "E&O Policy",
"category": "E&O",
"versions": [
{
"s3VersionId": "xN3TmQ8bJ0dY5fLpQ2rV9wK1sA6cE4hZ",
"metadataModel": "EAndOPolicy",
"size": 284913,
"mimeType": "application/pdf",
"originalFileName": "example-eando-2026.pdf"
}
],
"subCategory": "<string>",
"createdAt": "2025-01-15T10:30:00.000Z",
"updatedAt": "2026-02-12T09:00:00.000Z"
}
],
"total": 137,
"page": 1,
"limit": 50,
"totalPages": 3
},
"requestId": "dev-2c5e7cf2-9acf-4c8c-ab2f-b81f39d775a8",
"timestamp": "2025-11-12T20:49:03.293Z"
}{
"statusCode": 123,
"requestId": "<string>",
"errorType": "validation_error",
"errorMessage": [
"<string>"
],
"timestamp": "<string>",
"details": {}
}{
"statusCode": 123,
"requestId": "<string>",
"errorType": "validation_error",
"errorMessage": [
"<string>"
],
"timestamp": "<string>",
"details": {}
}{
"statusCode": 123,
"requestId": "<string>",
"errorType": "validation_error",
"errorMessage": [
"<string>"
],
"timestamp": "<string>",
"details": {}
}{
"statusCode": 123,
"requestId": "<string>",
"errorType": "validation_error",
"errorMessage": [
"<string>"
],
"timestamp": "<string>",
"details": {}
}{
"statusCode": 123,
"requestId": "<string>",
"errorType": "validation_error",
"errorMessage": [
"<string>"
],
"timestamp": "<string>",
"details": {}
}Documents
List Documents
The files your entities hold
GET
/
v2
/
downstream
/
documents
List documents
curl --request GET \
--url https://public.api.live.turrisfi.com/v2/downstream/documents \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://public.api.live.turrisfi.com/v2/downstream/documents', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://public.api.live.turrisfi.com/v2/downstream/documents"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"items": [
{
"fileDocumentId": "66a1b2c3d4e5f6a7b8c9d0e3",
"name": "E&O Policy",
"category": "E&O",
"versions": [
{
"s3VersionId": "xN3TmQ8bJ0dY5fLpQ2rV9wK1sA6cE4hZ",
"metadataModel": "EAndOPolicy",
"size": 284913,
"mimeType": "application/pdf",
"originalFileName": "example-eando-2026.pdf"
}
],
"subCategory": "<string>",
"createdAt": "2025-01-15T10:30:00.000Z",
"updatedAt": "2026-02-12T09:00:00.000Z"
}
],
"total": 137,
"page": 1,
"limit": 50,
"totalPages": 3
},
"requestId": "dev-2c5e7cf2-9acf-4c8c-ab2f-b81f39d775a8",
"timestamp": "2025-11-12T20:49:03.293Z"
}{
"statusCode": 123,
"requestId": "<string>",
"errorType": "validation_error",
"errorMessage": [
"<string>"
],
"timestamp": "<string>",
"details": {}
}{
"statusCode": 123,
"requestId": "<string>",
"errorType": "validation_error",
"errorMessage": [
"<string>"
],
"timestamp": "<string>",
"details": {}
}{
"statusCode": 123,
"requestId": "<string>",
"errorType": "validation_error",
"errorMessage": [
"<string>"
],
"timestamp": "<string>",
"details": {}
}{
"statusCode": 123,
"requestId": "<string>",
"errorType": "validation_error",
"errorMessage": [
"<string>"
],
"timestamp": "<string>",
"details": {}
}{
"statusCode": 123,
"requestId": "<string>",
"errorType": "validation_error",
"errorMessage": [
"<string>"
],
"timestamp": "<string>",
"details": {}
}Returns the documents your entities own, newest first: compliance policies, contracts and free-form files, with their version history.
Deleted documents are excluded.
Metadata only. No download URL is returned here.
s3VersionId identifies a version; it is not a link and cannot be fetched. To download a document, pass its id to Get a Download URL for a Document.Narrowing
downstreamEntityId limits the list to one entity, category to one document category.Authorizations
bearerrestricted-access-token
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
1-based page number
Required range:
x >= 1Example:
1
Page size (max 100)
Required range:
1 <= x <= 100Example:
50
Narrow the results to a single entity in your organization. Defaults to your whole subtree (your entity plus every branch beneath it). Returns 404 if the id is not in your subtree.
Example:
"6610b3d2c2e0a51b8c0d1f02"
Return only documents in this category. Defaults to every category.
Available options:
W9, E&O, Cyber, Producer Agreement, Crime & Fidelity, Other Contract, Other Document, Payment Details, License PDF, Contract Container Folder Document, Surplus Lines, Surplus Lines Tax Certification, Surplus Lines Diligent Effort, Surety Bond, custom question upload, market onboarding email attachment, market application pack source Example:
"E&O"
Was this page helpful?