Get a market
curl --request GET \
--url https://public.api.live.turrisfi.com/v2/downstream/markets/{upstreamDownstreamAssociationId}const options = {method: 'GET'};
fetch('https://public.api.live.turrisfi.com/v2/downstream/markets/{upstreamDownstreamAssociationId}', 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}"
response = requests.get(url)
print(response.text){
"data": {
"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"
},
"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
Get a Market
One carrier relationship in full
GET
/
v2
/
downstream
/
markets
/
{upstreamDownstreamAssociationId}
Get a market
curl --request GET \
--url https://public.api.live.turrisfi.com/v2/downstream/markets/{upstreamDownstreamAssociationId}const options = {method: 'GET'};
fetch('https://public.api.live.turrisfi.com/v2/downstream/markets/{upstreamDownstreamAssociationId}', 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}"
response = requests.get(url)
print(response.text){
"data": {
"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"
},
"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 one market: the carrier’s details, your entity’s side of the relationship, status and onboarding progress.
Returns 404 when the market is not one of yours.
The data-room token and access mode are never returned by this API. They are the credentials for token-gated external access to your data room; publishing them in a response would be handing out a bearer token.
Path Parameters
The unique identifier of the market (the upstreamDownstreamAssociationId returned by the List Markets endpoint).
Example:
"6627f1a9c2e0a51b8c0d4e3a"
Was this page helpful?