---
title: "Creates a new LEI for a given request."
method: POST
path: "/api/Lei"
tags: ["Lei"]
---

# Creates a new LEI for a given request.

`POST /api/Lei`

## Request

- Base URL: `https://api2.globalfinreg.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api2.globalfinreg.com/api/Lei`
- Auth: HTTP bearer

## Query parameters

- `Validated` boolean
- `b2BPriceKey` integer

## Request body

- Lei
  - `id` string, nullable
  - `leiNumber` string, nullable
  - `expiryDate` string, date-time, nullable
  - `paid` boolean, nullable
  - `internalRef` string, nullable
  - `legalEntity` LegalEntity
    - `countryCode` string, nullable
    - `regionCode` string, nullable
    - `regAuthCode` string, nullable
    - `bizRegNumber` string, nullable
    - `noBizRegNumber` boolean
    - `apiLinked` boolean
    - `entityName` string, nullable
    - `otherLegalName` string, nullable
    - `otherLegalNames` string[], nullable
    - `otherLanguageLegalNames` string[], nullable
    - `previousLegalName` string[], nullable
    - `website` string, nullable
    - `address` Address
      - `line1` string, nullable
      - `line2` string, nullable
      - `line3` string, nullable
      - `line4` string, nullable
      - `city` string, nullable
      - `postCode` string, nullable
      - `countryCode` string, nullable
      - `regionCode` string, nullable
    - `addressIsHqAddress` boolean
    - `headquartersAddress` HqAddress
      - `line1` string, nullable
      - `line2` string, nullable
      - `line3` string, nullable
      - `line4` string, nullable
      - `city` string, nullable
      - `postCode` string, nullable
      - `countryCode` string, nullable
      - `regionCode` string, nullable
    - `needDocs` boolean
    - `entCreationDate` string, date-time, nullable
    - `entCategory` integer, nullable
    - `entSubCategory` integer, nullable
    - `otherValidationFlag` boolean, nullable
    - `otherValidationAuthorityID` integer
    - `otherValidationAuthorityCode` string, nullable
    - `otherValidationAuthorityEntityId` string, nullable
    - `otherValidationISOCountryCode` string, nullable
    - `otherValidationISORegionCode` string, nullable
    - `needSealDocuments` boolean, nullable
    - `apiHasParents` boolean
    - `entityType` string, nullable
  - `directParentEntity` ParentEntity
    - `countryCode` string, nullable
    - `regionCode` string, nullable
    - `regAuthCode` string, nullable
    - `bizRegNumber` string, nullable
    - `noBizRegNumber` boolean
    - `apiLinked` boolean
    - `entityName` string, nullable
    - `otherLegalName` string, nullable
    - `otherLegalNames` string[], nullable
    - `otherLanguageLegalNames` string[], nullable
    - `previousLegalName` string[], nullable
    - `website` string, nullable
    - `address` Address
      - `line1` string, nullable
      - `line2` string, nullable
      - `line3` string, nullable
      - `line4` string, nullable
      - `city` string, nullable
      - `postCode` string, nullable
      - `countryCode` string, nullable
      - `regionCode` string, nullable
    - `addressIsHqAddress` boolean
    - `headquartersAddress` HqAddress
      - `line1` string, nullable
      - `line2` string, nullable
      - `line3` string, nullable
      - `line4` string, nullable
      - `city` string, nullable
      - `postCode` string, nullable
      - `countryCode` string, nullable
      - `regionCode` string, nullable
    - `needDocs` boolean
    - `entCreationDate` string, date-time, nullable
    - `entCategory` integer, nullable
    - `entSubCategory` integer, nullable
    - `otherValidationFlag` boolean, nullable
    - `otherValidationAuthorityID` integer
    - `otherValidationAuthorityCode` string, nullable
    - `otherValidationAuthorityEntityId` string, nullable
    - `otherValidationISOCountryCode` string, nullable
    - `otherValidationISORegionCode` string, nullable
    - `needSealDocuments` boolean, nullable
    - `disclosure` boolean, nullable
    - `nonDisclosureReason` string, nullable
    - `hasLei` boolean, nullable
    - `lei` string, nullable
    - `countryName` string, nullable
    - `regionName` string, nullable
    - `parentCountryCode` string, nullable
    - `parentRegionCode` string, nullable
    - `acctPeriodStartDate` string, date-time, nullable
    - `acctPeriodEndDate` string, date-time, nullable
    - `accountingStandard` integer, nullable
    - `relStartDate` string, date-time, nullable
    - `relEndDate` string, date-time, nullable
    - `pctOwned` integer, nullable
  - `ultimateParentEntity` UltimateParentEntity
    - `countryCode` string, nullable
    - `regionCode` string, nullable
    - `regAuthCode` string, nullable
    - `bizRegNumber` string, nullable
    - `noBizRegNumber` boolean
    - `apiLinked` boolean
    - `entityName` string, nullable
    - `otherLegalName` string, nullable
    - `otherLegalNames` string[], nullable
    - `otherLanguageLegalNames` string[], nullable
    - `previousLegalName` string[], nullable
    - `website` string, nullable
    - `address` Address
      - `line1` string, nullable
      - `line2` string, nullable
      - `line3` string, nullable
      - `line4` string, nullable
      - `city` string, nullable
      - `postCode` string, nullable
      - `countryCode` string, nullable
      - `regionCode` string, nullable
    - `addressIsHqAddress` boolean
    - `headquartersAddress` HqAddress
      - `line1` string, nullable
      - `line2` string, nullable
      - `line3` string, nullable
      - `line4` string, nullable
      - `city` string, nullable
      - `postCode` string, nullable
      - `countryCode` string, nullable
      - `regionCode` string, nullable
    - `needDocs` boolean
    - `entCreationDate` string, date-time, nullable
    - `entCategory` integer, nullable
    - `entSubCategory` integer, nullable
    - `otherValidationFlag` boolean, nullable
    - `otherValidationAuthorityID` integer
    - `otherValidationAuthorityCode` string, nullable
    - `otherValidationAuthorityEntityId` string, nullable
    - `otherValidationISOCountryCode` string, nullable
    - `otherValidationISORegionCode` string, nullable
    - `needSealDocuments` boolean, nullable
    - `disclosure` boolean, nullable
    - `nonDisclosureReason` string, nullable
    - `hasLei` boolean, nullable
    - `lei` string, nullable
    - `countryName` string, nullable
    - `regionName` string, nullable
    - `parentCountryCode` string, nullable
    - `parentRegionCode` string, nullable
    - `acctPeriodStartDate` string, date-time, nullable
    - `acctPeriodEndDate` string, date-time, nullable
    - `accountingStandard` integer, nullable
    - `relStartDate` string, date-time, nullable
    - `relEndDate` string, date-time, nullable
    - `pctOwned` integer, nullable
    - `sameAsDirectParent` boolean
  - `fundManagementEntity` FundManagementEntity
    - `countryCode` string, nullable
    - `regionCode` string, nullable
    - `regAuthCode` string, nullable
    - `bizRegNumber` string, nullable
    - `noBizRegNumber` boolean
    - `apiLinked` boolean
    - `entityName` string, nullable
    - `otherLegalName` string, nullable
    - `otherLegalNames` string[], nullable
    - `otherLanguageLegalNames` string[], nullable
    - `previousLegalName` string[], nullable
    - `website` string, nullable
    - `address` Address
      - `line1` string, nullable
      - `line2` string, nullable
      - `line3` string, nullable
      - `line4` string, nullable
      - `city` string, nullable
      - `postCode` string, nullable
      - `countryCode` string, nullable
      - `regionCode` string, nullable
    - `addressIsHqAddress` boolean
    - `headquartersAddress` HqAddress
      - `line1` string, nullable
      - `line2` string, nullable
      - `line3` string, nullable
      - `line4` string, nullable
      - `city` string, nullable
      - `postCode` string, nullable
      - `countryCode` string, nullable
      - `regionCode` string, nullable
    - `needDocs` boolean
    - `entCreationDate` string, date-time, nullable
    - `entCategory` integer, nullable
    - `entSubCategory` integer, nullable
    - `otherValidationFlag` boolean, nullable
    - `otherValidationAuthorityID` integer
    - `otherValidationAuthorityCode` string, nullable
    - `otherValidationAuthorityEntityId` string, nullable
    - `otherValidationISOCountryCode` string, nullable
    - `otherValidationISORegionCode` string, nullable
    - `needSealDocuments` boolean, nullable
    - `hasLei` boolean, nullable
    - `lei` string, nullable
    - `fundSelfManaged` boolean, nullable
    - `acctPeriodStartDate` string, date-time, nullable
    - `acctPeriodEndDate` string, date-time, nullable
    - `accountingStandard` integer, nullable
    - `relStartDate` string, date-time, nullable
    - `pctOwned` integer, nullable
  - `fundMasterFeederEntity` FundMasterFeederEntity
    - `countryCode` string, nullable
    - `regionCode` string, nullable
    - `regAuthCode` string, nullable
    - `bizRegNumber` string, nullable
    - `noBizRegNumber` boolean
    - `apiLinked` boolean
    - `entityName` string, nullable
    - `otherLegalName` string, nullable
    - `otherLegalNames` string[], nullable
    - `otherLanguageLegalNames` string[], nullable
    - `previousLegalName` string[], nullable
    - `website` string, nullable
    - `address` Address
      - `line1` string, nullable
      - `line2` string, nullable
      - `line3` string, nullable
      - `line4` string, nullable
      - `city` string, nullable
      - `postCode` string, nullable
      - `countryCode` string, nullable
      - `regionCode` string, nullable
    - `addressIsHqAddress` boolean
    - `headquartersAddress` HqAddress
      - `line1` string, nullable
      - `line2` string, nullable
      - `line3` string, nullable
      - `line4` string, nullable
      - `city` string, nullable
      - `postCode` string, nullable
      - `countryCode` string, nullable
      - `regionCode` string, nullable
    - `needDocs` boolean
    - `entCreationDate` string, date-time, nullable
    - `entCategory` integer, nullable
    - `entSubCategory` integer, nullable
    - `otherValidationFlag` boolean, nullable
    - `otherValidationAuthorityID` integer
    - `otherValidationAuthorityCode` string, nullable
    - `otherValidationAuthorityEntityId` string, nullable
    - `otherValidationISOCountryCode` string, nullable
    - `otherValidationISORegionCode` string, nullable
    - `needSealDocuments` boolean, nullable
    - `disclosure` boolean, nullable
    - `nonDisclosureReason` string, nullable
    - `hasLei` boolean, nullable
    - `lei` string, nullable
    - `fundMasterFeeder` boolean, nullable
    - `acctPeriodStartDate` string, date-time, nullable
    - `acctPeriodEndDate` string, date-time, nullable
    - `accountingStandard` integer, nullable
    - `relStartDate` string, date-time, nullable
    - `pctOwned` integer, nullable
  - `fundUmbrellaEntity` FundUmbrellaEntity
    - `countryCode` string, nullable
    - `regionCode` string, nullable
    - `regAuthCode` string, nullable
    - `bizRegNumber` string, nullable
    - `noBizRegNumber` boolean
    - `apiLinked` boolean
    - `entityName` string, nullable
    - `otherLegalName` string, nullable
    - `otherLegalNames` string[], nullable
    - `otherLanguageLegalNames` string[], nullable
    - `previousLegalName` string[], nullable
    - `website` string, nullable
    - `address` Address
      - `line1` string, nullable
      - `line2` string, nullable
      - `line3` string, nullable
      - `line4` string, nullable
      - `city` string, nullable
      - `postCode` string, nullable
      - `countryCode` string, nullable
      - `regionCode` string, nullable
    - `addressIsHqAddress` boolean
    - `headquartersAddress` HqAddress
      - `line1` string, nullable
      - `line2` string, nullable
      - `line3` string, nullable
      - `line4` string, nullable
      - `city` string, nullable
      - `postCode` string, nullable
      - `countryCode` string, nullable
      - `regionCode` string, nullable
    - `needDocs` boolean
    - `entCreationDate` string, date-time, nullable
    - `entCategory` integer, nullable
    - `entSubCategory` integer, nullable
    - `otherValidationFlag` boolean, nullable
    - `otherValidationAuthorityID` integer
    - `otherValidationAuthorityCode` string, nullable
    - `otherValidationAuthorityEntityId` string, nullable
    - `otherValidationISOCountryCode` string, nullable
    - `otherValidationISORegionCode` string, nullable
    - `needSealDocuments` boolean, nullable
    - `disclosure` boolean, nullable
    - `nonDisclosureReason` string, nullable
    - `hasLei` boolean, nullable
    - `lei` string, nullable
    - `fundUmbrella` boolean, nullable
    - `acctPeriodStartDate` string, date-time, nullable
    - `acctPeriodEndDate` string, date-time, nullable
    - `accountingStandard` integer, nullable
    - `relStartDate` string, date-time, nullable
    - `pctOwned` integer, nullable
  - `branchEntity` BranchEntity
    - `countryCode` string, nullable
    - `regionCode` string, nullable
    - `regAuthCode` string, nullable
    - `bizRegNumber` string, nullable
    - `noBizRegNumber` boolean
    - `apiLinked` boolean
    - `entityName` string, nullable
    - `otherLegalName` string, nullable
    - `otherLegalNames` string[], nullable
    - `otherLanguageLegalNames` string[], nullable
    - `previousLegalName` string[], nullable
    - `website` string, nullable
    - `address` Address
      - `line1` string, nullable
      - `line2` string, nullable
      - `line3` string, nullable
      - `line4` string, nullable
      - `city` string, nullable
      - `postCode` string, nullable
      - `countryCode` string, nullable
      - `regionCode` string, nullable
    - `addressIsHqAddress` boolean
    - `headquartersAddress` HqAddress
      - `line1` string, nullable
      - `line2` string, nullable
      - `line3` string, nullable
      - `line4` string, nullable
      - `city` string, nullable
      - `postCode` string, nullable
      - `countryCode` string, nullable
      - `regionCode` string, nullable
    - `needDocs` boolean
    - `entCreationDate` string, date-time, nullable
    - `entCategory` integer, nullable
    - `entSubCategory` integer, nullable
    - `otherValidationFlag` boolean, nullable
    - `otherValidationAuthorityID` integer
    - `otherValidationAuthorityCode` string, nullable
    - `otherValidationAuthorityEntityId` string, nullable
    - `otherValidationISOCountryCode` string, nullable
    - `otherValidationISORegionCode` string, nullable
    - `needSealDocuments` boolean, nullable
    - `disclosure` boolean, nullable
    - `nonDisclosureReason` string, nullable
    - `hasLei` boolean, nullable
    - `lei` string, nullable
    - `acctPeriodStartDate` string, date-time, nullable
    - `acctPeriodEndDate` string, date-time, nullable
    - `accountingStandard` integer, nullable
    - `relStartDate` string, date-time, nullable
    - `pctOwned` integer, nullable
    - `legalJurisdictionCountry` string, nullable
    - `legalForm` integer, nullable
    - `legalFormName` string, nullable
  - `rel` Relationships
    - `question1` boolean, nullable
    - `question2` boolean, nullable
    - `question3` boolean, nullable
  - `contact` Contact
    - `firstName` string, nullable
    - `lastName` string, nullable
    - `phone` string, nullable
    - `company` string, nullable
    - `signingAuthority` 0 | 1 | 2 | 3 | 4
    - `contactSigningAuthorityEmail` string, nullable
    - `contactSigningAuthorityPhone` string, nullable
    - `contactSigningAuthorityFirstName` string, nullable
    - `contactSigningAuthorityLastName` string, nullable
    - `contactSigningAuthorityPosition` string, nullable
    - `contactSigningAuthorityEmail2` string, nullable
    - `contactSigningAuthorityFirstName2` string, nullable
    - `contactSigningAuthorityLastName2` string, nullable
    - `contactSigningAuthorityPosition2` string, nullable
    - `signingAuthorityID` integer
  - `needDocuments` boolean
  - `needSealDocuments` boolean
  - `needSealNotarizedComReg` boolean
  - `needSealProofSigningRights` boolean
  - `needSealSignaturePOA` boolean
  - `limitedPoa` boolean
  - `userNameID` string, nullable
  - `fundType` integer, nullable
  - `fundMasterFeeder` boolean, nullable
  - `fundUmbrella` boolean, nullable
  - `branch` boolean, nullable
  - `autoRenewal` boolean
  - `noBusinessRegistryNo` boolean
  - `renewalPending` boolean, nullable
  - `renewalValidated` boolean, nullable
  - `multiYearOrderPending` boolean, nullable
  - `seal` ESeal
    - `eSealID` string, uuid
    - `leiID` string, uuid, nullable
    - `userNameID` string, uuid, nullable
    - `legalName` string, nullable
    - `businessRegistryNo` string, nullable
    - `integrationPartnerID` integer, nullable
    - `webPage` string, nullable
    - `address1` string, nullable
    - `address2` string, nullable
    - `city` string, nullable
    - `postCode` string, nullable
    - `country` string, nullable
    - `correspondenceAddress1` string, nullable
    - `correspondenceCity` string, nullable
    - `correspondencePostCode` string, nullable
    - `correspondenceCountry` string, nullable
    - `contactEmail` string, nullable
    - `sealType` 0 | 1 | 2
    - `signerType` 0 | 1 | 2
    - `individualCollective` string, nullable
    - `qesNotarizedCommercialRegister` string, nullable
    - `qesNotarizedCommercialRegisterConfirmation` boolean, nullable
    - `qesProofOfSigningRights` string, nullable
    - `configurationOrganizationalUnit` string, nullable
    - `configurationCityMunicipality` string, nullable
    - `configurationCanton` string, nullable
    - `qesPublicLinks` string, nullable
    - `thirdPartySigners` ESealSigner[], nullable
      - `eSealSignerID` string, uuid
      - `eSealID` string, uuid, nullable
      - `priority` integer, nullable
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `email` string, nullable
      - `phoneNumber` string, nullable
      - `role` string, nullable
      - `signatoryAPI` boolean
    - `apiSigners` ESealSigner[], nullable
      - `eSealSignerID` string, uuid
      - `eSealID` string, uuid, nullable
      - `priority` integer, nullable
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `email` string, nullable
      - `phoneNumber` string, nullable
      - `role` string, nullable
      - `signatoryAPI` boolean

## Response `200`

OK

---

[API](https://skmtc.dev/globalfinreg/apis/gfr-ai-agents-api.md) · [All operations](https://skmtc.dev/globalfinreg/apis/gfr-ai-agents-api/llms.txt) · [OpenAPI document](https://skmtc.dev/globalfinreg/apis/gfr-ai-agents-api/revisions/f8afe0178e1b?raw)