List a Market's Contacts

List a market contacts

curl --request GET \
  --url https://public.api.live.turrisfi.com/v2/downstream/markets/{upstreamDownstreamAssociationId}/market-contacts

const options = {method: 'GET'};

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));

{
  "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": {}
}

GET

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

const options = {method: 'GET'};

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));

{
  "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.

Path Parameters

upstreamDownstreamAssociationId

string

required

The unique identifier of the market (the upstreamDownstreamAssociationId returned by the List Markets endpoint).

Example:

"6627f1a9c2e0a51b8c0d4e3a"

Query Parameters

page

number

default:1

1-based page number

Required range: x >= 1

Example:

1

limit

number

default:50

Page size (max 100)

Required range: 1 <= x <= 100

Example:

50

Response

A page of market contacts

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

Path Parameters

Query Parameters

Response