List a market contacts
curl --request GET \
--url https://public.api.live.turrisfi.com/v2/downstream/markets/{upstreamDownstreamAssociationId}/market-contacts \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://public.api.live.turrisfi.com/v2/downstream/markets/{upstreamDownstreamAssociationId}/market-contacts', 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/markets/{upstreamDownstreamAssociationId}/market-contacts"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"items": [
{
"contactId": "66a1b2c3d4e5f6a7b8c9d0e2",
"displayName": "Jordan Alvarez",
"contactType": "person",
"roles": [
"underwriter"
],
"customRoles": [
{
"customRoleId": "66a1b2c3d4e5f6a7b8c9d0e1",
"name": "Surplus Lines Desk"
}
],
"isOwnedByYou": false,
"isCarrierWideAssignment": false,
"firstName": "Jordan",
"lastName": "Alvarez",
"label": "New Business Submissions",
"email": "example@test.com",
"phone": "+12125550188",
"createdAt": "2025-01-15T10:30:00.000Z",
"updatedAt": "2025-06-02T08:12:44.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": {}
}Markets
List a Market's Contacts
The carrier’s people on this relationship
GET
/
v2
/
downstream
/
markets
/
{upstreamDownstreamAssociationId}
/
market-contacts
List a market contacts
curl --request GET \
--url https://public.api.live.turrisfi.com/v2/downstream/markets/{upstreamDownstreamAssociationId}/market-contacts \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://public.api.live.turrisfi.com/v2/downstream/markets/{upstreamDownstreamAssociationId}/market-contacts', 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/markets/{upstreamDownstreamAssociationId}/market-contacts"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"items": [
{
"contactId": "66a1b2c3d4e5f6a7b8c9d0e2",
"displayName": "Jordan Alvarez",
"contactType": "person",
"roles": [
"underwriter"
],
"customRoles": [
{
"customRoleId": "66a1b2c3d4e5f6a7b8c9d0e1",
"name": "Surplus Lines Desk"
}
],
"isOwnedByYou": false,
"isCarrierWideAssignment": false,
"firstName": "Jordan",
"lastName": "Alvarez",
"label": "New Business Submissions",
"email": "example@test.com",
"phone": "+12125550188",
"createdAt": "2025-01-15T10:30:00.000Z",
"updatedAt": "2025-06-02T08:12:44.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": {}
}Returns the carrier’s people on this market — underwriters, territory managers, the shared submissions mailbox — with the roles they hold.
A contact is either a named person or a mailbox;
contactType says which. Roles come from a mix of standard roles and roles the carrier defined itself, and both are resolved to display names here rather than returned as ids.
This is the carrier’s side. For your own people on this market, use List Your Own Contacts on a Market.Authorizations
bearerrestricted-access-token
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The unique identifier of the market (the upstreamDownstreamAssociationId returned by the List Markets endpoint).
Example:
"6627f1a9c2e0a51b8c0d4e3a"
Query Parameters
1-based page number
Required range:
x >= 1Example:
1
Page size (max 100)
Required range:
1 <= x <= 100Example:
50
Was this page helpful?