# Legal name priority

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

Guide: AvaTax Excise

# Legal name priority

Understand how to specify and prioritize legal names using the `LegalNamePriority` field.

**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/)

Users must be able to specify a priority for a legal name. This is done using the `LegalNamePriority` field. This determines the value that a search of legal names will use first.

## 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
        }
      ]
    }
  ]
}
```