Skip to main content
GET
Get a download URL for a state template file
Returns two short-lived presigned links for one blank form listed by Get State Requirements: downloadUrl saves the file under its fileName, 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. Pass the state’s code and the file’s id from the requirements response as templateFileId.

Files you cannot download

A file on an item Turris keeps internal, a file no longer on the state’s requirements, a file id from another state and an unknown id all return the same 404.

Limits

This endpoint allows 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 stateCode is not a US state or territory code, or templateFileId is not a valid MongoDB ObjectId.

File Not Found (404)

Returned when Turris keeps no requirements for the state, or the file is internal, no longer listed or unknown.

Unauthorized (401)

Missing or invalid authentication token. See Authentication.

Forbidden (403)

Your organization is not entitled to the API, or does not have the Surplus-Lines Filing feature.

Too Many Requests (429)

Returned when the limit above is exceeded.

Authorizations

Authorization
string
header
required

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

Path Parameters

stateCode
enum<string>
required

US state or territory code

Available options:
AL,
AK,
AZ,
AR,
CA,
CO,
CT,
DE,
FL,
GA,
HI,
ID,
IL,
IN,
IA,
KS,
KY,
LA,
ME,
MD,
MA,
MI,
MN,
MS,
MO,
MT,
NE,
NV,
NH,
NJ,
NM,
NY,
NC,
ND,
OH,
OK,
OR,
PA,
RI,
SC,
SD,
TN,
TX,
UT,
VT,
VA,
WA,
WV,
WI,
WY,
GU,
PR,
VI,
DC
Example:

"TX"

templateFileId
string
required

Identifier of a template file, as returned in templateFiles[].id by Get State Requirements

Example:

"6650a1b2c3d4e5f6a7b8c9d2"

Response

Presigned download and view URLs

data
object
required
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"