# Name control

Source: https://developer.avalara.com/products/excise/integration-guides/excise/euy5102137311533/

Guide: AvaTax Excise

# 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](https://developer.avalara.com/api-reference/excise/v1/models/Avalara.Excise.Common.Contracts.Services.BusinessEntity_5_37_0/)

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](https://www.irs.gov/businesses/small-businesses-self-employed/how-your-name-control-is-assigned).

You can specify a name control during an import using the `NameControl` field in the [BusinessEntities](https://developer.avalara.com/api-reference/excise/v1/models/Avalara.Excise.Common.Contracts.Services.BusinessEntity_5_37_0/) 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
        }
      ]
    }
  ]
}
```