List approved carriers
curl --request GET \
--url https://public.api.live.turrisfi.com/v2/upstream/carriers \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://public.api.live.turrisfi.com/v2/upstream/carriers', 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/upstream/carriers"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"items": [
{
"name": "Liberty Mutual Insurance Company",
"companyCode": "23043",
"_id": "65f1a2b3c4d5e6f7a8b9c0d1",
"createdAt": "2025-11-12T20:49:03.293Z",
"updatedAt": "2025-11-12T20:49:03.293Z"
}
],
"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": {}
}Carriers
List Carriers
Turris’s approved carrier list, paginated and searchable
GET
/
v2
/
upstream
/
carriers
List approved carriers
curl --request GET \
--url https://public.api.live.turrisfi.com/v2/upstream/carriers \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://public.api.live.turrisfi.com/v2/upstream/carriers', 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/upstream/carriers"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"items": [
{
"name": "Liberty Mutual Insurance Company",
"companyCode": "23043",
"_id": "65f1a2b3c4d5e6f7a8b9c0d1",
"createdAt": "2025-11-12T20:49:03.293Z",
"updatedAt": "2025-11-12T20:49:03.293Z"
}
],
"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": {}
}Returns Turris’s approved carrier list. Read-only: adding a carrier to the list is handled internally, not through this API.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
search | string | No | Case-insensitive match against carrier name or NAIC company code |
page | number | No | 1-based page number. Defaults to 1 |
limit | number | No | Page size, max 100. Defaults to 50 |
Response Shape
All successful responses are wrapped in the standard response envelope. See Request/Response Conventions.
{
"data": {
"items": [
{
"_id": "65f1a2b3c4d5e6f7a8b9c0d1",
"name": "Liberty Mutual Insurance Company",
"companyCode": "23043",
"createdAt": "2025-11-12T20:49:03.293Z",
"updatedAt": "2025-11-12T20:49:03.293Z"
}
],
"total": 1,
"page": 1,
"limit": 50,
"totalPages": 1
},
"requestId": "abcd1234",
"timestamp": "2025-11-12T20:49:03.293Z"
}
Response Fields
| Field | Type | Description |
|---|---|---|
items | array | Carriers on the current page |
total | number | Total carriers matching the query |
page | number | 1-based page number |
limit | number | Page size |
totalPages | number | Total number of pages |
Error Scenarios
Bad Request (400)
Returned when a query parameter is out of range.{
"statusCode": 400,
"errorType": "validation_error",
"errorMessage": ["limit must not be greater than 100"],
"requestId": "abcd1234",
"timestamp": "2025-11-12T20:49:03.293Z"
}
Unauthorized (401)
Missing or invalid authentication token. See Authentication.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
Case-insensitive search matching carrier name or NAIC company code
Example:
"Liberty Mutual"
Was this page helpful?