List Licensed Entities

List licensed entities

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

const options = {method: 'GET'};

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

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

GET

downstream

entities

List licensed entities

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

const options = {method: 'GET'};

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

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

Pass downstreamEntityId 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.

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 licensed entities

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