Skip to main content
GET
List approved carriers
Returns Turris’s approved carrier list. Use a carrier’s _id as carrierId when you open a surplus-lines filing. Read-only: adding a carrier to the list is handled internally, not through this API.

Query Parameters

Response Shape

All successful responses are wrapped in the standard response envelope. See Request/Response Conventions.

Response Fields

Several carriers can share a name. Pick by companyCode, which is unique, and send the _id of that row as carrierId.

Access

This endpoint needs API access and nothing more: it is the same approved carrier list every Turris customer sees, so it does not depend on a product feature.

Limits

Like every read on the Agency API, 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 a query parameter is out of range.

Unauthorized (401)

Missing or invalid authentication token. See Authentication.

Forbidden (403)

Your organization is not entitled to the API, or the credential belongs to a carrier or MGA. Carriers use List Carriers on the Carrier & MGA API.

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.

Query Parameters

page
integer
default:1

1-based page number

Required range: x >= 1
Example:

1

limit
integer
default:50

Page size (max 100)

Required range: 1 <= x <= 100
Example:

50

Case-insensitive search matching carrier name or NAIC company code

Example:

"Liberty Mutual"

Response

One page of the approved carrier list

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"