List markets
curl --request GET \
--url https://public.api.live.turrisfi.com/v2/downstream/markets \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
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));import requests
url = "https://public.api.live.turrisfi.com/v2/downstream/markets"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"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": {}
}Markets
List Markets
The carriers you are appointed with, and where each relationship stands
GET
/
v2
/
downstream
/
markets
List markets
curl --request GET \
--url https://public.api.live.turrisfi.com/v2/downstream/markets \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
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));import requests
url = "https://public.api.live.turrisfi.com/v2/downstream/markets"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"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.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
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"
Was this page helpful?