Skip to main content
POST
https://dataapi.dncscrub.com
/
v1.5
/
legalentity
/
Create
Create Legal Entity
curl --request POST \
  --url https://dataapi.dncscrub.com/v1.5/legalentity/Create \
  --header 'Content-Type: <content-type>' \
  --header 'loginId: <loginid>' \
  --data '
{
  "LegalName": "<string>",
  "IsDefault": true,
  "EIN": "<string>",
  "StreetAddress": "<string>",
  "City": "<string>",
  "State": "<string>",
  "Zip": "<string>",
  "CountryCode": "<string>",
  "IndustryId": "<string>",
  "PrimaryPhoneNumber": "<string>",
  "PrimaryContactName": "<string>",
  "PrimaryContactEmail": "<string>",
  "PrimaryContactPhoneNumber": "<string>",
  "EmployeeCount": 123,
  "CallsPerMonth": 123,
  "DunsNumber": "<string>",
  "Url": "<string>",
  "Dba": "<string>",
  "LicenceNumber": "<string>",
  "CallPurposeDescription": "<string>",
  "PotentialNegativeReaction": "<string>"
}
'
{
  "LegalEntityId": 68257,
  "AcctId": "YOUR_ACCOUNT_ID",
  "IsCreated": true,
  "IsUpdated": false
}
Create a new legal entity for your account. Legal entities represent the business identities under which your phone numbers are registered and are used for carrier registration and compliance purposes.

​
Request

​
Headers

​
loginId
string
required
Your API Key (LoginId from your DNCScrub account)
​
Content-Type
string
required
Must be application/json

​
Request Body

​
LegalName
string
required
The registered legal name of the business entity
​
IsDefault
boolean
Set to true to make this the default legal entity for the account
​
EIN
string
Employer Identification Number (EIN), digits without a dash (e.g., “987654321”)
​
StreetAddress
string
Street address of the legal entity
​
City
string
City of the legal entity’s address
​
State
string
State or province code (e.g., “NY”, “CA”)
​
Zip
string
ZIP or postal code
​
CountryCode
string
Two-letter country code (e.g., “US”)
​
IndustryId
string
Industry identifier code. See the table below for valid values.
IDIndustry
1Education
2Transportation
3Retail
4Delivery/Shipping
5Government
6Health Care
7Financial
8Public Service
9Real Estate
10Legal
11Restaurant/Food Services
12Automotive
13Religious
14Veterinary Services
15Trade Contractors
16Personal Services
17Business Services
18Hospitality/Entertainment
19Insurance
20Manufacturing
21Other Business
22Telecommunications
​
PrimaryPhoneNumber
string
Primary contact phone number for the legal entity
​
PrimaryContactName
string
Name of the primary contact person
​
PrimaryContactEmail
string
Email address of the primary contact
​
PrimaryContactPhoneNumber
string
Phone number of the primary contact person
​
EmployeeCount
integer
Number of employees at the company
​
CallsPerMonth
integer
Estimated number of outbound calls per month
​
DunsNumber
string
Dun & Bradstreet DUNS number
​
Url
string
Company website URL
​
Dba
string
“Doing Business As” name, if different from legal name
​
LicenceNumber
string
Business license number
​
CallPurposeDescription
string
Description of the purpose of outbound calls
​
PotentialNegativeReaction
string
Description of potential negative reaction

​
Example Request

curl --location --request POST \
  'https://dataapi.dncscrub.com/v1.5/legalentity/Create' \
  --header 'loginId: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "IsDefault": false,
    "LegalName": "Test New Company LLC",
    "EIN": "123456789",
    "StreetAddress": "123 Main Street",
    "City": "Austin",
    "State": "TX",
    "Zip": "78701",
    "CountryCode": "US",
    "IndustryId": "7",
    "PrimaryContactName": "John Doe",
    "PrimaryContactEmail": "john.doe@testcompany.com",
    "PrimaryContactPhoneNumber": "5125551234",
    "PrimaryPhoneNumber": "5125550000",
    "CallsPerMonth": 10000,
    "EmployeeCount": 50,
    "DunsNumber": "123456789",
    "Url": "https://www.testcompany.com",
    "Dba": "Test Co",
    "LicenceNumber": "LIC-12345",
    "CallPurposeDescription": "Customer service follow-up calls",
    "PotentialNegativeReaction": "Low"
  }'

{
  "LegalEntityId": 68257,
  "AcctId": "YOUR_ACCOUNT_ID",
  "IsCreated": true,
  "IsUpdated": false
}

​
Response Fields

​
LegalEntityId
integer
The unique identifier assigned to the newly created legal entity
​
AcctId
string
The account ID the legal entity belongs to
​
IsCreated
boolean
true if a new legal entity was created
​
IsUpdated
boolean
Always false for the Create endpoint. If a legal entity with the same name exists, a 409 Conflict error is returned instead.

​
Error Responses

StatusDescription
400 Bad RequestMissing required fields (e.g., LegalName) or request body is empty
401 UnauthorizedInvalid or missing API key
409 ConflictA legal entity with the same LegalName already exists
500 Internal Server ErrorServer error during processing