Sign in

v1

latestOpenAPI 3.1.02026-08-0662251219.8 KB
Legal Entities

Update legal entity

This endpoint updates a legal entity by ID.

put/v2/companies/{companyId}/legal-entities/{legalEntityId}

Request body

idstring uuid

Unique identifier of the legal entity.

namestring

Name of the legal entity

registeredNamestring

The official name of this legal entity as registered with local tax authorities.

registeredEmailstring

The primary email (or alias) used for the "Registered name" of this legal entity. Used for official communications, including regulatory, compliance, and invoicing purposes.

billingCurrencystring

Billing currency for the legal entity.

dbastring

Business name, sort form of Doing Business As

einstring

Tax number

isDelayedInvoicingEnabledboolean

Whether delayed invoicing is enabled for the legal entity. If enabled, travelers of the legal entity won't be charged for trip on checkout, rather the bills would be sent to the company later on based on the billing cycle.

ccEmailAddressesstring[]

List of email addresses on which all confirmation emails will be CCed. This is applicable only for company roles 'ORG'

bccEmailAddressesstring[]

List of email addresses on which all confirmation emails will be BCCed. This is applicable only for company roles 'ORG'

externalIdstring

External id for the legal entity.

Example request

{
  "address": {
    "addressLines": [
      "Golden Gate Bridge"
    ],
    "administrativeArea": "CA",
    "administrativeAreaName": "California",
    "description": "San Francisco Home",
    "isDefault": true,
    "languageCode": "en",
    "locality": "San Francisco",
    "locationCode": "LAX",
    "organization": "Spotnana",
    "postalCode": "94130",
    "continentCode": "AF",
    "regionCode": "US",
    "regionName": "America",
    "revision": 1,
    "sortingCode": "Jamaica",
    "timezone": "America/Los_Angeles",
    "coordinates": {
      "latitude": 77.1025,
      "longitude": 28.7041
    }
  },
  "billingAddress": {
    "addressLines": [
      "Golden Gate Bridge"
    ],
    "administrativeArea": "CA",
    "administrativeAreaName": "California",
    "description": "San Francisco Home",
    "isDefault": true,
    "languageCode": "en",
    "locality": "San Francisco",
    "locationCode": "LAX",
    "organization": "Spotnana",
    "postalCode": "94130",
    "continentCode": "AF",
    "regionCode": "US",
    "regionName": "America",
    "revision": 1,
    "sortingCode": "Jamaica",
    "timezone": "America/Los_Angeles",
    "coordinates": {
      "latitude": 77.1025,
      "longitude": 28.7041
    }
  },
  "phoneNumbers": [
    {
      "countryCode": 91,
      "countryCodeSource": "FROM_NUMBER_WITH_PLUS_SIGN",
      "extension": "222",
      "isoCountryCode": "IN",
      "italianLeadingZero": true,
      "nationalNumber": 8150,
      "numberOfLeadingZeros": 1,
      "preferredDomesticCarrierCode": "7",
      "rawInput": "77777",
      "type": "MOBILE"
    }
  ],
  "bookingTmcRef": {
    "id": "b93dc51f-12dd-46c7-b7d6-1cb12cd3f5b3",
    "name": "Name"
  },
  "expensePartnerConfig": {
    "partner": "EXPENSIFY",
    "emailConfig": {
      "personalCardConfig": {
        "personalCardExpenseEmail": "user@company.com"
      },
      "centralCardExpenseEmail": "finance+le@company.com",
      "expensePartnerEmail": "receipts@expensify.com",
      "bccEmail": "docs@company.com"
    },
    "travelType": [
      "AIR"
    ],
    "isExpensePartnerEnabled": true,
    "reportCustomFields": true,
    "personalCardExpenseOwner": {
      "traveler": true,
      "centralEmail": "docs@company.com"
    },
    "centralCardExpenseOwner": {
      "traveler": true,
      "centralEmail": "docs@company.com"
    },
    "partnerReferralId": "1234hgd",
    "itineraryConfig": {
      "skipModificationUpdate": true,
      "skipCancellationUpdate": true
    }
  },
  "ccEmailAddresses": [
    "example@gmail.com"
  ],
  "bccEmailAddresses": [
    "example@gmail.com"
  ],
  "externalId": "my-external-id",
  "companySpecifiedAttributes": [
    {
      "fieldName": "businessId",
      "value": "ABCD"
    }
  ]
}

Response

Updated Successfully