Sign in

v1

latestOpenAPI 3.1.02026-08-0662251219.8 KB
Legal Entities

Create legal entity

This endpoint creates a legal entity.

post/v2/companies/{companyId}/legal-entities

Request body

namestring required

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 required

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 for this LE will be cc'ed. This is applicable only for company roles 'ORG'

bccEmailAddressesstring[]

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

externalIdstring

External id for 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"
    }
  ],
  "ccEmailAddresses": [
    "example@gmail.com"
  ],
  "bccEmailAddresses": [
    "example@gmail.com"
  ],
  "externalId": "legal-entity-external-id",
  "companySpecifiedAttributes": [
    {
      "fieldName": "businessId",
      "value": "ABCD"
    }
  ]
}

Response

Created

idstring uuid required

Example response

{
  "id": "b93dc51f-12dd-46c7-b7d6-1cb12cd3f5b3"
}