List licensed entities
curl --request GET \
--url https://public.api.live.turrisfi.com/v2/downstream/entities \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://public.api.live.turrisfi.com/v2/downstream/entities', 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/entities"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"items": [
{
"downstreamEntityId": "6610b3d2c2e0a51b8c0d1f02",
"branchName": "Philadelphia Branch",
"isTopCompany": false,
"incorporationStateCodes": [
"PA"
],
"legalName": "Example Insurance Services, LLC",
"doingBusinessAs": "Example Insurance",
"npn": "1234567",
"ein": "12-3456789",
"category": "agency",
"parentId": "6610b3d2c2e0a51b8c0d1f01",
"ultimateParentId": "6610b3d2c2e0a51b8c0d1f01",
"dateIncorporated": "2015-06-01T00:00:00.000Z",
"website": "https://example-insurance.com",
"phoneNumber": "+12155550100",
"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"
},
"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": {}
}Licensed Entities
List Licensed Entities
Every legal entity in your organization, including its branches
GET
/
v2
/
downstream
/
entities
List licensed entities
curl --request GET \
--url https://public.api.live.turrisfi.com/v2/downstream/entities \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://public.api.live.turrisfi.com/v2/downstream/entities', 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/entities"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"items": [
{
"downstreamEntityId": "6610b3d2c2e0a51b8c0d1f02",
"branchName": "Philadelphia Branch",
"isTopCompany": false,
"incorporationStateCodes": [
"PA"
],
"legalName": "Example Insurance Services, LLC",
"doingBusinessAs": "Example Insurance",
"npn": "1234567",
"ein": "12-3456789",
"category": "agency",
"parentId": "6610b3d2c2e0a51b8c0d1f01",
"ultimateParentId": "6610b3d2c2e0a51b8c0d1f01",
"dateIncorporated": "2015-06-01T00:00:00.000Z",
"website": "https://example-insurance.com",
"phoneNumber": "+12155550100",
"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"
},
"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 legal entities your credential can see: your own organization plus every branch beneath it. This is the endpoint to call first — most other endpoints take a
downstreamEntityId that comes from here.
Scope is your subtree, not your whole group. A credential minted at the top company sees the top company and all its branches. A credential minted at a branch sees that branch and nothing above or beside it. See Downstream Getting Started for why.
Narrowing
PassdownstreamEntityId to return a single entity. An id outside your subtree returns 404, the same response as an id that does not exist — we do not confirm that another agency’s entity exists.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?