List Markets

List markets

curl --request GET \
  --url https://public.api.live.turrisfi.com/v2/downstream/markets

const options = {method: 'GET'};

fetch('https://public.api.live.turrisfi.com/v2/downstream/markets', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "items": [
      {
        "upstreamDownstreamAssociationId": "6627f1a9c2e0a51b8c0d4e3a",
        "downstreamEntityId": "6610b3d2c2e0a51b8c0d1f02",
        "branchName": "Philadelphia Branch",
        "category": "agency",
        "upstreamEntity": {
          "upstreamEntityId": "65f0a1b2c3d4e5f6a7b8c9d0",
          "legalName": "Example Specialty Insurance Co.",
          "category": "carrier"
        },
        "producerCount": 12,
        "onboarding": {
          "isIdentityDone": true,
          "isProfileDone": true,
          "isMemberCreationDone": true,
          "isUploadDocumentsDone": true,
          "isRequestedAuthorityDone": false,
          "isPaymentDetailsDone": false,
          "isCustomQuestionsDone": false,
          "isLicensedProducersDone": false,
          "isPreContractReviewDone": false,
          "isContractSigned": false
        },
        "isInvited": true,
        "hasAcknowledgedTerms": true,
        "producerCode": "PA-0042",
        "externalId": "CRM-88213",
        "doingBusinessAs": "Example Insurance",
        "website": "https://example-insurance.com",
        "portalUrl": "https://partners.example.example/login",
        "phoneNumber": "+12155550100",
        "faxNumber": "+12155550101",
        "legalAddress": {
          "country": "USA",
          "line1": "1200 Market St",
          "line2": "Suite 400",
          "city": "Philadelphia",
          "zip": "19107",
          "state": "PA"
        },
        "mailingAddress": {
          "country": "USA",
          "line1": "1200 Market St",
          "line2": "Suite 400",
          "city": "Philadelphia",
          "zip": "19107",
          "state": "PA"
        },
        "parentUpstreamDownstreamAssociationId": "6627f1a9c2e0a51b8c0d4e39",
        "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

List markets

curl --request GET \
  --url https://public.api.live.turrisfi.com/v2/downstream/markets

const options = {method: 'GET'};

fetch('https://public.api.live.turrisfi.com/v2/downstream/markets', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "items": [
      {
        "upstreamDownstreamAssociationId": "6627f1a9c2e0a51b8c0d4e3a",
        "downstreamEntityId": "6610b3d2c2e0a51b8c0d1f02",
        "branchName": "Philadelphia Branch",
        "category": "agency",
        "upstreamEntity": {
          "upstreamEntityId": "65f0a1b2c3d4e5f6a7b8c9d0",
          "legalName": "Example Specialty Insurance Co.",
          "category": "carrier"
        },
        "producerCount": 12,
        "onboarding": {
          "isIdentityDone": true,
          "isProfileDone": true,
          "isMemberCreationDone": true,
          "isUploadDocumentsDone": true,
          "isRequestedAuthorityDone": false,
          "isPaymentDetailsDone": false,
          "isCustomQuestionsDone": false,
          "isLicensedProducersDone": false,
          "isPreContractReviewDone": false,
          "isContractSigned": false
        },
        "isInvited": true,
        "hasAcknowledgedTerms": true,
        "producerCode": "PA-0042",
        "externalId": "CRM-88213",
        "doingBusinessAs": "Example Insurance",
        "website": "https://example-insurance.com",
        "portalUrl": "https://partners.example.example/login",
        "phoneNumber": "+12155550100",
        "faxNumber": "+12155550101",
        "legalAddress": {
          "country": "USA",
          "line1": "1200 Market St",
          "line2": "Suite 400",
          "city": "Philadelphia",
          "zip": "19107",
          "state": "PA"
        },
        "mailingAddress": {
          "country": "USA",
          "line1": "1200 Market St",
          "line2": "Suite 400",
          "city": "Philadelphia",
          "zip": "19107",
          "state": "PA"
        },
        "parentUpstreamDownstreamAssociationId": "6627f1a9c2e0a51b8c0d4e39",
        "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": {}
}

A market is your relationship with one carrier. This returns them: who the carrier is, which of your entities holds the relationship, its status, and where onboarding has got to.

Narrowing

downstreamEntityId limits the list to markets held by one of your entities.

The identifier is called upstreamDownstreamAssociationId, not marketId. It names the association between your entity and the carrier, and it is the same value the contacts endpoints publish under that name — one concept, one name.

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

downstreamEntityId

string

Narrow the results to a single entity in your organization. Defaults to your whole subtree (your entity plus every branch beneath it). Returns 404 if the id is not in your subtree.

Example:

"6610b3d2c2e0a51b8c0d1f02"

Response

A page of markets

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

Narrowing

Query Parameters

Response

​Narrowing

Query Parameters

Response

Narrowing