Skip to main content
POST
/
v1
/
downstream-entity-associations
/
dangerously-add
cURL
curl --request POST \
  --url https://public.api.live.turrisfi.com/v1/downstream-entity-associations/dangerously-add \
  --header 'Content-Type: application/json' \
  --data '
{
  "firstName": "John",
  "lastName": "Doe",
  "email": "john.doe@example.com",
  "isNpnRequired": true,
  "category": "agency",
  "downstreamEntityNpn": "12345678",
  "branchName": "West Coast Branch",
  "downstreamEntityName": "ABC Insurance Agency",
  "producerCode": "PROD-001",
  "externalId": "EXT-12345",
  "parentProducerCode": "PARENT-001",
  "parentDownstreamEntityAssociationId": "507f1f77bcf86cd799439011",
  "ein": "12-3456789"
}
'
{
  "data": {
    "_id": "<string>",
    "downstreamEntity": {
      "_id": "<string>",
      "isNpnRequired": true,
      "legalName": "<string>",
      "category": "<string>",
      "npn": "<string>",
      "ein": "<string>"
    },
    "niprDataSubscription": {
      "dataOwnerId": "<string>",
      "dataOwnerModel": "<string>",
      "entityModel": "<string>",
      "entityInfo": {
        "status": "<string>",
        "jobId": "<string>",
        "message": "<string>",
        "rawEntityInfoId": "<string>"
      },
      "npn": "<string>",
      "lastSynchronizationDate": "2023-11-07T05:31:56Z",
      "pdbAlertsSubscriptionStatus": "<string>",
      "pdbAlertsPausedAt": "2023-11-07T05:31:56Z"
    },
    "producerCode": "<string>",
    "externalId": "<string>"
  },
  "requestId": "dev-2c5e7cf2-9acf-4c8c-ab2f-b81f39d775a8",
  "timestamp": "2025-11-12T20:49:03.293Z"
}
Deprecated: This endpoint bypasses validation checks and should only be used for special migration scenarios. Use the standard Add endpoint instead.
Adds a downstream entity directly without performing standard validation checks.

Headers

ā€‹
idempotency-key
string

UUID to ensure idempotent request processing

ā€‹
x-idempotency-key
string

Alternative UUID header for idempotent request processing

Body

application/json
ā€‹
firstName
string
required

First name of the primary contact

Example:

"John"

ā€‹
lastName
string
required

Last name of the primary contact

Example:

"Doe"

ā€‹
email
string
required

Email address of the primary contact

Example:

"john.doe@example.com"

ā€‹
isNpnRequired
boolean
required

Whether NPN is required for this downstream entity

Example:

true

ā€‹
category
enum<string>
required

Category of the downstream entity

Available options:
agency,
agency network,
wholesale brokerage,
third party administrator
Example:

"agency"

ā€‹
downstreamEntityNpn
string

National Producer Number (NPN) of the downstream entity. Required when isNpnRequired is true.

Example:

"12345678"

ā€‹
branchName
string

Branch name. Required when parentProducerCode is provided.

Example:

"West Coast Branch"

ā€‹
downstreamEntityName
string

Name of the downstream entity. Required when NPN is not provided.

Example:

"ABC Insurance Agency"

ā€‹
producerCode
string

Producer code for this downstream entity

Example:

"PROD-001"

ā€‹
externalId
string

External identifier for integration purposes

Example:

"EXT-12345"

ā€‹
parentProducerCode
string

Producer code of the parent entity (for branch relationships)

Example:

"PARENT-001"

ā€‹
parentDownstreamEntityAssociationId
string

Parent downstream entity association ID (for branch relationships)

Example:

"507f1f77bcf86cd799439011"

ā€‹
ein
string

Federal Employer Identification Number (EIN/FEIN)

Example:

"12-3456789"

Response

Downstream entity added (deprecated)

ā€‹
data
object
required
ā€‹
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"