Get a Download URL for a Document

Get a download URL for a document

curl --request GET \
  --url https://public.api.live.turrisfi.com/v2/downstream/documents/{fileDocumentId}/download-url \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://public.api.live.turrisfi.com/v2/downstream/documents/{fileDocumentId}/download-url', 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/{fileDocumentId}/download-url"

headers = {"Authorization": "Bearer <token>"}

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

print(response.text)

{
  "data": {
    "downloadUrl": "https://files.example.com/d?X-Amz-Signature=abc",
    "viewUrl": "https://files.example.com/v?X-Amz-Signature=def",
    "fileName": "policy.pdf",
    "contentType": "application/pdf",
    "expiresAt": "2026-09-29T13:00:00.000Z"
  },
  "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": {}
}

GET

downstream

documents

{fileDocumentId}

download-url

Get a download URL for a document

curl --request GET \
  --url https://public.api.live.turrisfi.com/v2/downstream/documents/{fileDocumentId}/download-url \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://public.api.live.turrisfi.com/v2/downstream/documents/{fileDocumentId}/download-url', 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/{fileDocumentId}/download-url"

headers = {"Authorization": "Bearer <token>"}

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

print(response.text)

{
  "data": {
    "downloadUrl": "https://files.example.com/d?X-Amz-Signature=abc",
    "viewUrl": "https://files.example.com/v?X-Amz-Signature=def",
    "fileName": "policy.pdf",
    "contentType": "application/pdf",
    "expiresAt": "2026-09-29T13:00:00.000Z"
  },
  "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 two short-lived presigned links for one document: downloadUrl saves the file under its original name, and viewUrl opens it in a browser. Both stop working at expiresAt, one hour after the call. Fetch a fresh pair when you need one rather than storing the links. It works for every document List Documents returns, and for the files on your surplus-lines filings that you can see in the filing response. Files on checklist items Turris keeps internal are never served: they return 404, the same response as an id that does not exist. For a file on a filing, pass the fileDocumentId the filing response shows on that file: every checklist attachment, the policy document and every completion artifact carries one. That is also how you fetch a file someone else put on the filing, such as a document Turris attached. An attachment’s _id identifies the attachment record, not the document, and returns 404 here.

Which version you get

For a compliance document you get the version List Documents shows. To get the copy one carrier holds instead, the one List a Market’s Documents shows for your own compliance documents, pass that market’s id as upstreamDownstreamAssociationId. Files the carrier shared into a relationship (isSharedByCarrier: true in that list) are not downloadable here and return 404. Pass versionId (an S3 version id from the document’s version history) to pick a specific version. The market id is ignored for categories that have no per-market copies.

Limits

Like every read on the Agency API, this endpoint is limited to 120 requests per 60 seconds per organization. Past that it returns 429 with a Retry-After header. See Rate Limiting.

Error Scenarios

Bad Request (400)

Returned when fileDocumentId or a query parameter is not valid.

Document Not Found (404)

Returned when the document does not exist or is not in your organization, sits on a checklist item Turris keeps internal, the market is not yours, or versionId is not one of its versions.

Too Many Requests (429)

Returned when the rate limit above is exceeded.

Unauthorized (401)

Missing or invalid authentication token. See Authentication.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

fileDocumentId

string

required

Unique identifier of the document

Example:

"66a1b2c3d4e5f6a7b8c9d0e3"

Query Parameters

versionId

string

S3 version id of the version to download, from the document version history. Defaults to the latest version.

Example:

"Xo2f9mK1Qv.3a7b"

upstreamDownstreamAssociationId

string

A market id from List Markets. Downloads the copy that market holds, the one List a Market Documents shows, instead of the version List Documents shows. Ignored for categories without per-market copies.

Example:

"507f1f77bcf86cd799439011"

Response

Presigned download and view URLs

data

object

required

Show child attributes

requestId

string

required

Unique request identifier

Example:

"dev-2c5e7cf2-9acf-4c8c-ab2f-b81f39d775a8"

timestamp

string

required

Response timestamp

Example:

"2025-11-12T20:49:03.293Z"

Start Here

Shared Endpoints

Licensed Entities

Producers

Contacts

Licenses

Actions Required

Licensing Overview

Appointments

License Requests

Compliance Configurations

Markets

Corporate Registrations

Documents

Surplus Lines

Get a Download URL for a Document

Which version you get

Limits

Error Scenarios

Bad Request (400)

Document Not Found (404)

Too Many Requests (429)

Unauthorized (401)

Authorizations

Path Parameters

Query Parameters

Response

​Which version you get

​Limits

​Error Scenarios

​Bad Request (400)

​Document Not Found (404)

​Too Many Requests (429)

​Unauthorized (401)

Authorizations

Path Parameters

Query Parameters

Response

Which version you get

Limits

Error Scenarios

Bad Request (400)

Document Not Found (404)

Too Many Requests (429)

Unauthorized (401)