Name control

Learn about the NameControl element, its purpose, and how to specify it in your integration.

Element type: Required for Core

Endpoints/models used: BusinessEntities

Your integration should provide users with an option to specify a business's name control. The name control is the sequence of characters that are derived from a taxpayer's name. These characters are used by the IRS in processing tax returns filed by the taxpayer. More information about name controls is available in the IRS web site.

You can specify a name control during an import using the NameControl field in the BusinessEntities model.

Example

{
  "ImportName": "BE_API_TEST",  //--Required
  "UpdateMatchesMode": "INSERT",  //--Required
  "TerminateNewRecords": false,  //--Required
  "CreateAllAccountTypes": true,  //--Required
  "LoadId": "LOAD_GUID_HERE",  //--Required
  "BusinessEntities": [
    {
      "LegalName": "TEST_BE",  //--Required
      "LegalNamePriority": 0,  //--Required
      "TradeName": "TEST_BE",
      "NameControl": "TES",
      "EffectiveDate": "2024-09-01T14:55:52.950Z",  //--Required
      "ObsoleteDate": "2024-09-01T14:55:52.950Z",
      "Address1": "110 Main Street",
      "Address2": "Suite 100",
      "City": "Houston",
      "Jurisdiction": "TX",
      "PostalCode": "77002",
      "CountryCode": "USA",
      "County": "HARRIS",
      "CustomId": "TEST_BE",  //--Required
      "CustomIdPriority": 0,  //--Required
      "IdCodeAndIdTypePriority": 0,  //--Required
      "BusinessEntityMappingId": "BE_GUID_HERE", //--Required
      "BusinessEntityIdCodes": [  //--Required
        {
          "CountryCode": "USA",  //--Required
          "IdType": "FEIN",  //--Required
          "IdCode": "999999999"  //--Required
        }
      ],
      "BusinessAccounts": [
        {
          "CountryCode": "USA",
          "Jurisdiction": "CA",
          "BusinessType": "BUY",
          "BusinessSubType": "TOBMANUF",
          "CustomId": null,
          "EffectiveDate": "2020-01-01T00:00:00",
          "ObsoleteDate": null,
          "LicenseNumber": "123456789",
          "LicensePercentage": null,
          "BusinessAccountMappingId": null
        }
      ]
    }
  ]
}